Section courante

A propos

Section administrative du site

INSERT

Insère
SQL Server Microsoft SQL Server

Syntaxe

[ WITH common_table_expression [ ,...n ] ]
INSERT
{
      [ TOP ( expression ) [ PERCENT ] ]
      [ INTO ]
      { | rowset_function_limited
         [ WITH ( Table_Hint_Limited [ ...n ] ) ]
      }
      {
      [ ( column_list ) ]
      [ <OUTPUT Clause> ]
      { VALUES ( { DEFAULT | NULL | expression } [ ,...n ] ) [ ,...n ]
      | derived_table
      | execute_statement
      | dml_table_source
      | DEFAULT VALUES
      }
      }
}
[;]

::=
{
   [ server_name . database_name . schema_name .
      | database_name .[ schema_name ] .
      | schema_name .
   ]
   table_or_view_name
}

dml_table_source ::=
      SELECT select_list
      FROM ( dml_statement_with_output_clause )
            [AS] table_alias [ ( column_alias [ ,...n ] ) ]
      [ WHERE search_condition ]
            [ OPTION ( query_hint [ ,...n ] ) ]
INSERT
{
      [BULK]
      { database_name.schema_name.table_or_view_name | schema_name.table_or_view_name | table_or_view_name }
      ( column_definition )
      [ WITH (
            [ [ , ] CHECK_CONSTRAINTS ]
            [ [ , ] FIRE_TRIGGERS ]
            [ [ , ] KEEP_NULLS ]
            [ [ , ] KILOBYTES_PER_BATCH = kilobytes_per_batch ]
            [ [ , ] ROWS_PER_BATCH = rows_per_batch ]
            [ [ , ] ORDER ( { column [ ASC | DESC ] } [ ,...n ] ) ]
            [ [ , ] TABLOCK ]
      ) ]
}

[; ] column_definition ::=
column_name data_type
      [ COLLATE collation_name ]
      [ NULL | NOT NULL ]

data type ::=
[ type_schema_name . ] type_name
      [ ( precision [ , scale ] | max ]

Paramètres

Nom Description
WITH common_table_expression Ce paramètre permet d'indiquer l'ensemble de résultats nommé temporaire, également appelé expression de table commune, définie dans l'étendu de l'instruction INSERT. L'ensemble de résultats est dérivé d'une instruction SELECT.
TOP (expression) [ PERCENT ] (expression) [ PERCENT ] Ce paramètre permet d'indiquer le nombre ou le pourcentage de lignes aléatoires à insérer. Le paramètre expression peut être un nombre ou un pourcentage d'un enregistrement.
INTO Ce paramètre permet d'indiquer le mot clef facultatif pouvant être utilisé entre INSERT et la table destinataire.
server_name Ce paramètre permet d'indiquer le nom du serveur lié sur lequel se trouve la table ou la vue. Le paramètre server_name peut être spécifié en tant que nom de serveur lié ou à l'aide de la fonction OPENDATASOURCE. Lorsque le paramètre server_name est spécifié en tant que serveur lié, les paramètres database_name et schema_name sont obligatoires. Lorsque le paramètre server_name est spécifié avec OPENDATASOURCE, les paramètres database_name et schema_name peuvent ne pas s'appliquer à toutes les sources de données et sont soumis aux fonctionnalités du fournisseur OLE DB accédant à l'objet à distance.
database_name Ce paramètre permet d'indiquer le nom de la base de données.
schema_name Ce paramètre permet d'indiquer le nom du schéma auquel appartient la table ou la vue.
table_or_view_name Ce paramètre permet d'indiquer le nom de la table ou de la vue recevant les données.
rowset_function_limited Ce paramètre permet d'indiquer la fonction OPENQUERY ou OPENROWSET. L'utilisation de ces fonctions dépend des fonctionnalités du fournisseur OLE DB accédant à l'objet à distance.
WITH ( table_hint_limited [... n ] ) Ce paramètre permet d'indiquer un ou plusieurs indicateurs de table autorisés pour une table destinataire. Le mot clef WITH et les parenthèses sont obligatoires.
(column_list) Ce paramètre permet d'indiquer une liste d'une ou de plusieurs colonnes dans lesquelles insérer des données. Le paramètre column_list doit être entre parenthèses et délimité par des virgules.
OUTPUT Clause Ce paramètre permet de retourner les lignes insérées dans le cadre de l'opération d'insertion. Les résultats peuvent être renvoyés à l'application de traitement ou insérés dans une table ou une variable de table pour un traitement ultérieur.
VALUES Ce paramètre permet d'introduire la liste ou les listes de valeurs de données à insérer. Il doit y avoir une valeur de données pour chaque colonne dans la column_list, si elle est spécifiée, ou dans la table. La liste de valeurs doit être entre parenthèses.
DEFAULT Ce paramètre permet de forcer le moteur de base de données à charger la valeur par défaut définie pour une colonne. S'il n'existe pas de valeur par défaut pour la colonne et que la colonne autorise les valeurs NULL, NULL est inséré. Pour une colonne définie avec le type de données timestamp, la valeur timestamp suivante est insérée. Le paramètre DEFAULT n'est pas valide pour une colonne d'identité.
expression Ce paramètre permet d'indiquer une constante, une variable ou une expression. L'expression ne peut pas contenir d'instruction EXECUTE.
derived_table Ce paramètre permet d'indiquer toute instruction SELECT valide renvoyant des lignes de données à charger dans la table. L'instruction SELECT ne peut pas contenir une expression de table commune (CTE).
execute_statement Ce paramètre permet d'indiquer toute instruction EXECUTE valide renvoyant des données avec les instructions SELECT ou READTEXT.
dml_table_source Ce paramètre permet d'indiquer que les lignes insérées dans la table cible sont celles renvoyées par la clause OUTPUT d'une instruction INSERT, UPDATE, DELETE ou MERGE, éventuellement filtrée par une clause WHERE. Si dml_table_source est spécifié, la destination de l'instruction INSERT externe doit respecter les restrictions suivantes : elle doit être une table de base, pas une vue, elle ne peut pas être une table à distance, elle ne peut pas avoir de déclencheur défini sur celle-ci, elle ne peut pas participer à aucune relation de clef primaire-clef étrangère et elle ne peut pas participer à la réplication de fusion ni aux abonnements pouvant être mis à jour pour la réplication transactionnelle. Le niveau de compatibilité de la base de données doit être égal ou supérieur à 100.
select_list Ce paramètre permet d'indiquer une liste séparée par des virgules spécifiant les colonnes renvoyées par la clause OUTPUT à insérer. Les colonnes de select_list doivent être compatibles avec les colonnes dans lesquelles des valeurs sont insérées. Le paramètre select_list ne peut pas faire référence à des fonctions d'agrégat ou à TEXTPTR.
dml_statement_with_output_clause Ce paramètre permet d'indiquer qu'il s'agit d'une instruction INSERT, UPDATE, DELETE ou MERGE validant que le retour des lignes affectées dans une clause OUTPUT. L'instruction ne peut pas contenir de clause WITH ni cibler des tables à distance ou des vues partitionnées. Si UPDATE ou DELETE est spécifié, il ne peut s'agir d'un UPDATE ou DELETE basée sur un curseur. Les lignes source ne peuvent pas être référencées comme des instructions DML imbriquées.
WHERE search_condition Ce paramètre permet d'indiquer que toute clause WHERE contenant un search_condition valide filtrant les lignes renvoyées par dml_statement_with_output_clause.
DEFAULT VALUES Ce paramètre permet de forcer la nouvelle ligne à contenir les valeurs par défaut définies pour chaque colonne.
BULK Ce paramètre permet d'indiquer qu'un outil externe télécharge un flux de données binaire. Ce paramètre n'est pas conçue pour être utilisée avec des outils tels que SQL Server Management Studio, SQLCMD, OSQL ou des interfaces de programmation d'applications d'accès aux données telles que SQL Server Native Client.
FIRE_TRIGGERS Ce paramètre permet d'indiquer que tous les déclencheurs d'insertion définis sur la table de destination s'exécutent pendant l'opération de téléchargement du flux de données binaires.
CHECK_CONSTRAINTS Ce paramètre permet d'indiquer que toutes les contraintes sur la table ou la vue destinataire doivent être vérifiées lors de l'opération de téléchargement du flux de données binaires.
KEEPNULLS Ce paramètre permet d'indiquer que les colonnes vides doivent conserver une valeur null lors de l'opération de téléchargement du flux de données binaires.
KILOBYTES_PER_BATCH = kilobytes_per_batch Ce paramètre permet d'indiquer le nombre approximatif de kilo-octets (Ko) de données par lot en kilobytes_per_batch.
ROWS_PER_BATCH =rows_per_batch Ce paramètre permet d'indiquer le nombre approximatif de lignes de données dans le flux de données binaires.

Description

Cette instruction permet d'insérer un ou plusieurs enregistrement dans une table ou une vue de SQL Server.

Remarques



Dernière mise à jour : Samedi, le 4 novembre 2017