INSERT |
Insère |
|---|---|
| SQL Server | Microsoft SQL Server |
Syntaxe
|
[ WITH common_table_expression [ ,...n ] ] INSERT { [ TOP ( expression ) [ PERCENT ] ] [ INTO ] { |
|
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
- Si vous avez le message d'erreur suivant :
- Vous pouvez utiliser la fonction @@ROWCOUNT pour renvoyer le nombre de lignes insérées à l'application cliente.
- Vous pouvez intégrer le traitement des erreurs pour l'instruction INSERT en spécifiant l'instruction dans une construction de style TRY ... CATCH.
| Cannot insert explicit value for identity column in table 'table' when IDENTITY_INSERT is set to OFF |
Vous devrez entourer votre requête de la façon suivante pour autoriser l'insertion :
SET IDENTITY_INSERT [300500].[dbo].[table] ON
INSERT ...
SET IDENTITY_INSERT [300500].[dbo].[table] OFF
Dernière mise à jour : Samedi, le 4 novembre 2017