La documentación de MySQL dice lo siguiente sobre las consultas del tipo INSERT INTO ...
:
Las columnas para las que la sentencia proporciona valores se pueden
especificar de la siguiente manera:
Puede proporcionar una lista separada por comas de nombres de columna después del nombre de la tabla. En este caso, un valor
para cada columna nombrada debe ser proporcionado por la lista
VALUES
o la instrucción SELECT
.
Si no especifica una lista de nombres de columna para INSERT ... VALUES
o INSERT ... SELECT
, los valores de cada columna de la
tabla deben proporcionarse mediante la lista VALUES
o la sentencia
SELECT
. Si no conoce el orden de las columnas en la tabla, use
DESCRIBE tbl_name
para averiguarlo.
La segunda opción significa, en otras palabras, que puedes escribir una sentencia como esta:
INSERT INTO tu_tabla VALUES ('valor-columna1-varchar', valor-columna2-int ...)
Como se puede ver, no aparece la lista de columnas a la izquierda de VALUES
... en ese caso se debe proporcionar un valor para cada columna en el orden en que las mismas están definidas en la tabla, pasando este valor según el tipo de la columna (varchar, int, etc).
Aunque esto se puede hacer, lo normal es construir nuestro INSERT
como se indica en la 1ª opción, es decir, indicar de forma explícita a la izquierda de VALUES
los nombres de las columnas donde queremos insertar los datos y a la derecha de VALUES
los valores que queremos insertar.
Para responder a tu pregunta:
En la sentencia INSERT INTO
es obligatorio escribir todos los campos
de la tabla sin importar que todos los valores (variables) en el campo
VALUE no reciban datos.
Supongamos una tabla como esta:
CREATE TABLE IF NOT EXISTS
ejemplo_insert (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
nombre VARCHAR(10) NOT NULL,
apellido VARCHAR (50),
documento VARCHAR (10) NOT NULL DEFAULT '**********'
);
Veamos ahora varios casos.
Caso 1: todo normal... como debe ser
Si escribes una consulta como esta para insertar datos en la tabla anterior:
INSERT INTO ejemplo_insert
(nombre, apellido) VALUES ('Pedro','Pérez');
Es obligatorio pasar a la consulta un valor para la columna nombre
y otro valor para la columna apellido
. Aquí se omite la columna documento
en la instrucción SQL, pero los datos se insertan, porque dicha columna tiene definido un valor predeterminado, el cual asumirá al crearse el registro.
Caso 2: No tan normal... pero funciona
INSERT INTO ejemplo_insert
(nombre, apellido) VALUES ('','Pérez');
Esta consulta funcionaría, porque estás introduciendo en nombre
datos en blanco, que no es lo mismo que nulo.
Caso 3: Tampoco tan normal, pero funciona
INSERT INTO ejemplo_insert
(nombre, apellido) VALUES ('Pedro',NULL);
También funciona, porque en este caso la columna apellido
sí admite nulos.
Caso 4: Omitiendo el valor de una columna indicada en la lista
Si escribes una consulta así:
INSERT INTO ejemplo_insert
(nombre, apellido) VALUES ('Pedro');
Tendrás derecho al error siguiente en MySQL:
Column count doesn't match value count
Es decir, ¡me dijiste que iba a introducir datos en dos columnas, pero me estás dando datos de una solamente!.
Caso 5: Tratar de introducir un valor nulo en una columna que no admite nulos
Otra cosa que puede ocurrir es que intentes introducir un valor nulo NULL
, en una columna que no admite nulos. Por ejemplo:
INSERT INTO ejemplo_insert
(nombre, apellido) VALUES (NULL,'Pérez');
Aquí tendrás derecho al error siguiente:
Column 'nombre' cannot be null
Si ves el CREATE TABLE
de más arriba entenderás el motivo de esta protesta del sistema :)
Sin embargo, en el caso 2 no dio error, porque se introdujo un valor en blanco, no un nulo, porque NULL
y
no es lo mismo.
Caso 6: Omitir en la sentencia SQL una columna que no admite nulos y que al mismo tiempo no tiene definido un valor por defecto
En la siguiente consulta:
INSERT INTO ejemplo_insert
(apellido) VALUES ('Pérez');
Vas a merecer el error siguiente:
Field 'nombre' doesn't have a default value
Porque omitiste de la sentencia SQL la columna nombre
la cual, ni admite nulos ni tiene un valor por defecto. Verás que no ha ocurrido lo mismo con la columna documento
la cual ha sido omitida en esta y otras instrucciones de inserción. ¿Por qué no reclama nada con respecto a documento
y sí con respecto a nombre
? Porque como documento
tiene definido un valor por defecto, las nuevas filas creadas asumen dicho valor cuando la columna es omitida en cualquier sentencia.
Recomendación
Es fuertemente recomendado el uso de consultas preparadas en todos los manejos de base de datos que incluyan datos desde el exterior, ya que enviar consultas enteras, es decir, en las que va toda la instrucción, es una puerta abierta a la Inyección SQL. Lo que hacen las consultas preparadas es separar los datos de la instrucción SQL en sí, dando más seguridad e incluso facilidad al código.
Ver al respecto:
INSERT
sería el equivalente a tratar de introducir valores nulos en ellos, tendrías el error:Field 'nombredecolumna' doesn't have a default value
. A no ser que dichas columnas tengan un valor predeterminado, el cual tendrían en el caso de no estar en la sentenciaINSERT
(esto último no lo he probado, ahora lo pruebo y edito mi respuesta).