Инструкция INSERT (Transact-SQL)INSERT (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server даБаза данных SQL Azure даAzure Synapse Analytics (хранилище данных SQL) даParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

Добавляет одну или несколько строк в таблицу или представление SQL ServerSQL Server.Adds one or more rows to a table or a view in SQL ServerSQL Server. Примеры см. в разделе Примеры.For examples, see Examples.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

-- Syntax for SQL Server and Azure SQL Database  

[ WITH <common_table_expression> [ ,...n ] ]  
INSERT   
{  
        [ TOP ( expression ) [ PERCENT ] ]   
        [ INTO ]   
        { <object> | 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   
        }  
    }  
}  
[;]  
  
<object> ::=  
{   
    [ 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 ] ) ]  
-- External tool only syntax  

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 ]  
-- Syntax for Azure SQL Data Warehouse and Parallel Data Warehouse  

INSERT INTO { database_name.schema_name.table_name | schema_name.table_name | table_name }
    [ ( column_name [ ,...n ] ) ]  
    {   
      VALUES ( { NULL | expression } )  
      | SELECT <select_criteria>  
    }  
    [ OPTION ( <query_option> [ ,...n ] ) ]  
[;]  

АргументыArguments

WITH <common_table_expression>WITH <common_table_expression>
Определяет временный именованный результирующий набор, также называемый обобщенным табличным выражением, определенным в области инструкции INSERT.Specifies the temporary named result set, also known as common table expression, defined within the scope of the INSERT statement. Результирующий набор получается из инструкции SELECT.The result set is derived from a SELECT statement. Дополнительные сведения см. в разделе WITH common_table_expression (Transact-SQL).For more information, see WITH common_table_expression (Transact-SQL).

TOP (expression) [ PERCENT ]TOP (expression) [ PERCENT ]
Задает число или процент вставляемых случайных строк.Specifies the number or percent of random rows that will be inserted. expression может быть либо числом, либо процентом от числа строк.expression can be either a number or a percent of the rows. Дополнительные сведения см. в разделе TOP (Transact-SQL).For more information, see TOP (Transact-SQL).

INTOINTO
Необязательное ключевое слово, которое можно использовать между ключевым словом INSERT и целевой таблицей.Is an optional keyword that can be used between INSERT and the target table.

server_nameserver_name
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Имя связанного сервера, на котором расположены таблица или представление.Is the name of the linked server on which the table or view is located. server_name может указываться как имя связанного сервера или с помощью функции OPENDATASOURCE.server_name can be specified as a linked server name, or by using the OPENDATASOURCE function.

Когда server_name указывается как имя связанного сервера, необходимо указать database_name и schema_name.When server_name is specified as a linked server, database_name and schema_name are required. Если server_name указано с помощью OPENDATASOURCE, то аргументы database_name и schema_name могут применяться не ко всем источникам данных, в зависимости от возможностей поставщика OLE DB, который обращается к удаленному объекту.When server_name is specified with OPENDATASOURCE, database_name and schema_name may not apply to all data sources and is subject to the capabilities of the OLE DB provider that accesses the remote object.

database_namedatabase_name
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Имя базы данных.Is the name of the database.

schema_nameschema_name
Имя схемы, которой принадлежит таблица или представление.Is the name of the schema to which the table or view belongs.

table_or view_nametable_or view_name
Имя таблицы или представления, которые принимают данные.Is the name of the table or view that is to receive the data.

В качестве источника таблицы в инструкции INSERT можно использовать табличную переменную внутри своей области.A table variable, within its scope, can be used as a table source in an INSERT statement.

Представление, на которое ссылается аргумент table_or_view_name, должно быть обновляемым и ссылаться только на одну базовую таблицу в предложении FROM в представлении.The view referenced by table_or_view_name must be updatable and reference exactly one base table in the FROM clause of the view. Например, инструкция INSERT в многотабличном представлении должна использовать аргумент column_list, который ссылается только на столбцы из одной базовой таблицы.For example, an INSERT into a multi-table view must use a column_list that references only columns from one base table. Дополнительные сведения об обновляемых представлениях см. в разделе CREATE VIEW (Transact-SQL).For more information about updatable views, see CREATE VIEW (Transact-SQL).

rowset_function_limitedrowset_function_limited
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Либо функция OPENQUERY, либо функция OPENROWSET.Is either the OPENQUERY or OPENROWSET function. Использование этих функций зависит от возможностей поставщика OLE DB, который обращается к удаленному объекту.Use of these functions is subject to the capabilities of the OLE DB provider that accesses the remote object.

WITH ( <table_hint_limited> [... n ] )WITH ( <table_hint_limited> [... n ] )
Задает одно или несколько табличных указаний, разрешенных для целевой таблицы.Specifies one or more table hints that are allowed for a target table. Ключевое слово WITH и круглые скобки обязательны.The WITH keyword and the parentheses are required.

Нельзя использовать подсказки READPAST, NOLOCK, и READUNCOMMITTED.READPAST, NOLOCK, and READUNCOMMITTED are not allowed. Дополнительные сведения о табличных указаниях см. в разделе Табличные указания (Transact-SQL).For more information about table hints, see Table Hints (Transact-SQL).

Важно!

Возможность указать подсказки HOLDLOCK, SERIALIZABLE, READCOMMITTED, REPEATABLEREAD или UPDLOCK в целевых таблицах инструкций INSERT будет удалена в будущих версиях SQL ServerSQL Server.The ability to specify the HOLDLOCK, SERIALIZABLE, READCOMMITTED, REPEATABLEREAD, or UPDLOCK hints on tables that are targets of INSERT statements will be removed in a future version of SQL ServerSQL Server. Эти указания не влияют на производительность инструкций INSERT.These hints do not affect the performance of INSERT statements. Избегайте применять их в новых разработках и запланируйте внесение изменений в приложения, использующие их в настоящее время.Avoid using them in new development work, and plan to modify applications that currently use them.

Указание подсказки TABLOCK для целевой таблицы инструкции INSERT приведет к тем же последствиям, что и указание подсказки TABLOCKX.Specifying the TABLOCK hint on a table that is the target of an INSERT statement has the same effect as specifying the TABLOCKX hint. К таблице будет применена монопольная блокировка.An exclusive lock is taken on the table.

(column_list)(column_list)
Список, состоящий из одного или нескольких столбцов, в которые вставляются данные.Is a list of one or more columns in which to insert data. Список column_list должен быть заключен в круглые скобки, а его элементы должны разделяться запятыми.column_list must be enclosed in parentheses and delimited by commas.

Если столбец не внесен в column_list, то компонент Компонент Database EngineDatabase Engine должен обеспечить значение, основанное на определении столбца; в противном случае строку нельзя будет загрузить.If a column is not in column_list, the Компонент Database EngineDatabase Engine must be able to provide a value based on the definition of the column; otherwise, the row cannot be loaded. Компонент Компонент Database EngineDatabase Engine автоматически задает значение для столбца, если столбец имеет следующие характеристики.The Компонент Database EngineDatabase Engine automatically provides a value for the column if the column:

  • Имеется свойство IDENTITY.Has an IDENTITY property. Используется следующее значение приращения для идентификатора.The next incremental identity value is used.

  • Имеется стандартное значение.Has a default. Используется стандартное значение для столбца.The default value for the column is used.

  • Имеет тип данных timestamp.Has a timestamp data type. В этом случае используется текущее значение отметки времени.The current timestamp value is used.

  • Допускает значение NULL.Is nullable. Используется значение NULL.A null value is used.

  • Вычисляемый столбец.Is a computed column. Используется вычисленное значение.The calculated value is used.

Аргумент column_list необходимо использовать, когда в столбец идентификаторов вставляются явно заданные значения, а параметру SET IDENTITY_INSERT необходимо присвоить значение ON для таблицы.column_list must be used when explicit values are inserted into an identity column, and the SET IDENTITY_INSERT option must be ON for the table.

Предложение OUTPUTOUTPUT Clause
Возвращает вставленные строки во время операции вставки.Returns inserted rows as part of the insert operation. Результаты могут возвращаться в обрабатывающее приложение или вставляться в таблицу или табличную переменную для дальнейшей обработки.The results can be returned to the processing application or inserted into a table or table variable for further processing.

Предложение OUTPUT не поддерживается инструкциями DML, которые ссылаются на локальные секционированные представления, распределенные секционированные представления или удаленные таблицы, или инструкциями INSERT, содержащими аргумент execute_statement.The OUTPUT clause is not supported in DML statements that reference local partitioned views, distributed partitioned views, or remote tables, or INSERT statements that contain an execute_statement. Предложение OUTPUT INTO не поддерживается в инструкциях INSERT, содержащих предложение <dml_table_source>.The OUTPUT INTO clause is not supported in INSERT statements that contain a <dml_table_source> clause.

VALUESVALUES
Позволяет использовать один или несколько списков вставляемых значений данных.Introduces the list or lists of data values to be inserted. Для каждого столбца в column_list, если этот параметр указан, или в таблице должно быть одно значение.There must be one data value for each column in column_list, if specified, or in the table. Список значений должен быть заключен в скобки.The value list must be enclosed in parentheses.

Если значения в списке идут в порядке, отличном от порядка следования столбцов в таблице, или не для каждого столбца таблицы определено значение, то необходимо использовать аргумент column_list для явного указания столбца, в котором хранится каждое входное значение.If the values in the Value list are not in the same order as the columns in the table or do not have a value for each column in the table, column_list must be used to explicitly specify the column that stores each incoming value.

Можно использовать конструктор строк Transact-SQLTransact-SQL (также называемый конструктором табличных значений), позволяющий указать несколько строк в одной инструкции INSERT.You can use the Transact-SQLTransact-SQL row constructor (also called a table value constructor) to specify multiple rows in a single INSERT statement. Этот конструктор строк состоит из одного предложения VALUES со списками из нескольких значений, заключенными в круглые скобки и разделенными запятыми.The row constructor consists of a single VALUES clause with multiple value lists enclosed in parentheses and separated by a comma. Дополнительные сведения см. в разделе Конструктор табличных значений (Transact-SQL).For more information, see Table Value Constructor (Transact-SQL).

DEFAULTDEFAULT
Указывает компоненту Компонент Database EngineDatabase Engine необходимость принудительно загружать значения по умолчанию, определенные для столбца.Forces the Компонент Database EngineDatabase Engine to load the default value defined for a column. Если для столбца не задано значение по умолчанию и он может содержать значение NULL, вставляется значение NULL.If a default does not exist for the column and the column allows null values, NULL is inserted. В столбцы с типом данных timestamp вставляется следующее значение метки времени.For a column defined with the timestamp data type, the next timestamp value is inserted. Значение DEFAULT недопустимо для столбца идентификаторов.DEFAULT is not valid for an identity column.

expressionexpression
Константа, переменная или выражение.Is a constant, a variable, or an expression. Выражение не может содержать инструкцию EXECUTE.The expression cannot contain an EXECUTE statement.

При ссылке на типы данных символов Юникода nchar, nvarchar и ntext выражение 'expression' должно начинаться с заглавной буквы 'N'.When referencing the Unicode character data types nchar, nvarchar, and ntext, 'expression' should be prefixed with the capital letter 'N'. Если префикс «N» не указан, SQL ServerSQL Server выполнит преобразование строки в кодовую страницу, соответствующую параметрам сортировки базы данных или столбца, действующим по умолчанию.If 'N' is not specified, SQL ServerSQL Server converts the string to the code page that corresponds to the default collation of the database or column. Любые символы, не входящие в эту кодовую страницу, будут утрачены.Any characters not found in this code page are lost.

derived_tablederived_table
Любая допустимая инструкция SELECT, возвращающая строки данных, которые загружаются в таблицу.Is any valid SELECT statement that returns rows of data to be loaded into the table. Инструкция SELECT не может содержать обобщенное табличное выражение (CTE).The SELECT statement cannot contain a common table expression (CTE).

execute_statementexecute_statement
Любая допустимая инструкция EXECUTE, возвращающая данные с помощью инструкций SELECT или READTEXT.Is any valid EXECUTE statement that returns data with SELECT or READTEXT statements. Дополнительные сведения см. в разделе EXECUTE (Transact-SQL).For more information, see EXECUTE (Transact-SQL).

Параметры RESULT SETS инструкции EXECUTE нельзя указывать в инструкции INSERT…EXEC.The RESULT SETS options of the EXECUTE statement cannot be specified in an INSERT...EXEC statement.

Если аргумент execute_statement используется с инструкцией INSERT, каждый результирующий набор должен быть совместим со столбцами в таблице или списке column_list.If execute_statement is used with INSERT, each result set must be compatible with the columns in the table or in column_list.

Аргумент execute_statement может применяться для выполнения хранимых процедур на том же сервере или на сервере, расположенном удаленно.execute_statement can be used to execute stored procedures on the same server or a remote server. На удаленном сервере выполняется процедура, результирующий набор возвращается на локальный сервер и загружается в таблицу на локальном сервере.The procedure in the remote server is executed, and the result sets are returned to the local server and loaded into the table in the local server. В распределенной транзакции нельзя выполнить инструкцию execute_statement для связанного сервера с замыканием на себя, если при соединении включен режим MARS (множественный активный результирующий набор).In a distributed transaction, execute_statement cannot be issued against a loopback linked server when the connection has multiple active result sets (MARS) enabled.

Если execute_statement возвращает данные с помощью инструкции READTEXT, каждая инструкция READTEXT может возвращать не более 1 МБ (1024 КБ) данных.If execute_statement returns data with the READTEXT statement, each READTEXT statement can return a maximum of 1 MB (1024 KB) of data. execute_statement также может использоваться при работе с расширенными процедурами.execute_statement can also be used with extended procedures. execute_statement вставляет данные, возвращенные главным потоком расширенной процедуры; однако выходные данные из других потоков (кроме главного) не вставляются.execute_statement inserts the data returned by the main thread of the extended procedure; however, output from threads other than the main thread are not inserted.

Возвращающий табличное значение параметр нельзя указывать в качестве объекта инструкции INSERT EXEC, но его можно указать в виде источника в строке INSERT EXEC или в хранимой процедуре.You cannot specify a table-valued parameter as the target of an INSERT EXEC statement; however, it can be specified as a source in the INSERT EXEC string or stored-procedure. Дополнительные сведения см. в статье Использование возвращающих табличные значения параметров (компонент Database Engine).For more information, see Use Table-Valued Parameters (Database Engine).

<dml_table_source><dml_table_source>
Указывает, что вставленные в целевую таблицу строки были возвращены предложением OUTPUT инструкции INSERT, UPDATE, DELETE или MERGE с возможной фильтрацией предложением WHERE.Specifies that the rows inserted into the target table are those returned by the OUTPUT clause of an INSERT, UPDATE, DELETE, or MERGE statement, optionally filtered by a WHERE clause. Если используется аргумент <dml_table_source>, целевая таблица внешней инструкции INSERT должна удовлетворять следующим ограничениям:If <dml_table_source> is specified, the target of the outer INSERT statement must meet the following restrictions:

  • Быть базовой таблицей, а не представлением.It must be a base table, not a view.

  • Не быть удаленной таблицей.It cannot be a remote table.

  • Не иметь определенных для нее триггеров.It cannot have any triggers defined on it.

  • Не участвовать в связях «первичный-внешний ключ».It cannot participate in any primary key-foreign key relationships.

  • Объект не должен участвовать в репликации слиянием или обновляемых подписках для репликации транзакций.It cannot participate in merge replication or updatable subscriptions for transactional replication.

Уровень совместимости базы данных должен быть не ниже 100.The compatibility level of the database must be set to 100 or higher. Дополнительные сведения см. в статье Предложение OUTPUT (Transact-SQL).For more information, see OUTPUT Clause (Transact-SQL).

<select_list><select_list>
Список с разделителями-запятыми, указывающий, какие столбцы возвращены предложением OUTPUT для вставки.Is a comma-separated list specifying which columns returned by the OUTPUT clause to insert. Столбцы в <select_list> должны быть совместимы со столбцами, в которые вставляются значения.The columns in <select_list> must be compatible with the columns into which values are being inserted. <select_list> не может ссылаться на агрегатные функции или TEXTPTR.<select_list> cannot reference aggregate functions or TEXTPTR.

Примечание

Любые перечисленные в списке SELECT переменные ссылаются на свои исходные значения, независимо от любых изменений, произошедших с ними в <dml_statement_with_output_clause>.Any variables listed in the SELECT list refer to their original values, regardless of any changes made to them in <dml_statement_with_output_clause>.

<dml_statement_with_output_clause><dml_statement_with_output_clause>
Допустимая инструкция INSERT, UPDATE, DELETE или MERGE, возвращающая изменяемые строки в предложении OUTPUT.Is a valid INSERT, UPDATE, DELETE, or MERGE statement that returns affected rows in an OUTPUT clause. Инструкция не может содержать предложение WITH и использовать удаленные таблицы или секционированные представления в качестве целевых.The statement cannot contain a WITH clause, and cannot target remote tables or partitioned views. Если указаны UPDATE или DELETE, это не могут быть использующие курсор инструкции UPDATE или DELETE.If UPDATE or DELETE is specified, it cannot be a cursor-based UPDATE or DELETE. На исходные строки нельзя ссылаться как на вложенные инструкции DML.Source rows cannot be referenced as nested DML statements.

WHERE <search_condition>WHERE <search_condition>
Любое предложение WHERE, содержащее допустимый критерий поиска <search_condition>, фильтрующее строки, которые возвращены аргументом <dml_statement_with_output_clause>.Is any WHERE clause containing a valid <search_condition> that filters the rows returned by <dml_statement_with_output_clause>. Дополнительные сведения см. в разделе Условие поиска (Transact-SQL).For more information, see Search Condition (Transact-SQL). При использовании в этом контексте критерий <search_condition> не должен содержать вложенных запросов, определяемых пользователем скалярных функций, выполняющих доступ к данным, агрегатных функций, TEXTPTR или предикатов полнотекстового поиска.When used in this context, <search_condition> cannot contain subqueries, scalar user-defined functions that perform data access, aggregate functions, TEXTPTR, or full-text search predicates.

DEFAULT VALUESDEFAULT VALUES
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Заполняет новую строку значениями по умолчанию, определенными для каждого столбца.Forces the new row to contain the default values defined for each column.

BULKBULK
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Используется внешними средствами для передачи потока двоичных данных.Used by external tools to upload a binary data stream. Этот параметр не предназначен для использования с такими средствами, как среда SQL Server Management StudioSQL Server Management Studio, SQLCMD, OSQL или программными интерфейсами для доступа к данным, такими как Native Client SQL ServerSQL Server.This option is not intended for use with tools such as SQL Server Management StudioSQL Server Management Studio, SQLCMD, OSQL, or data access application programming interfaces such as SQL ServerSQL Server Native Client.

FIRE_TRIGGERSFIRE_TRIGGERS
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Указывает, что при передаче потока двоичных данных будут выполняться триггеры INSERT, определенные для целевой таблицы.Specifies that any insert triggers defined on the destination table execute during the binary data stream upload operation. Дополнительные сведения см. в разделе BULK INSERT (Transact-SQL).For more information, see BULK INSERT (Transact-SQL).

CHECK_CONSTRAINTSCHECK_CONSTRAINTS
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Указывает, что при передаче потока двоичных данных будет выполняться проверка всех ограничений целевой таблицы или представления.Specifies that all constraints on the target table or view must be checked during the binary data stream upload operation. Дополнительные сведения см. в разделе BULK INSERT (Transact-SQL).For more information, see BULK INSERT (Transact-SQL).

KEEPNULLSKEEPNULLS
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Указывает, что пустые столбцы во время передачи потока двоичных данных должны сохранить значение NULL.Specifies that empty columns should retain a null value during the binary data stream upload operation. Дополнительные сведения см. в разделе Сохранение значений NULL или использование значений по умолчанию при массовом импорте данных (SQL Server).For more information, see Keep Nulls or Use Default Values During Bulk Import (SQL Server).

KILOBYTES_PER_BATCH = kilobytes_per_batchKILOBYTES_PER_BATCH = kilobytes_per_batch
Определяет приблизительное число килобайт данных в пакете как kilobytes_per_batch.Specifies the approximate number of kilobytes (KB) of data per batch as kilobytes_per_batch. Дополнительные сведения см. в разделе BULK INSERT (Transact-SQL).For more information, see BULK INSERT (Transact-SQL).

ROWS_PER_BATCH =rows_per_batchROWS_PER_BATCH =rows_per_batch
Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

Указывает приблизительное число строк в потоке двоичных данных.Indicates the approximate number of rows of data in the binary data stream. Дополнительные сведения см. в разделе BULK INSERT (Transact-SQL).For more information, see BULK INSERT (Transact-SQL).

Примечание

Если список столбцов отсутствует, то возникает синтаксическая ошибка.A syntax error is raised if a column list is not provided.

RemarksRemarks

Дополнительную информацию о вставке данных в графовые таблицы SQL см. в разделе INSERT (Граф SQL).For information specific to inserting data into SQL graph tables, see INSERT (SQL Graph).

РекомендацииBest Practices

Для возврата в клиентское приложение количества вставленных строк используйте функцию @@ROWCOUNT.Use the @@ROWCOUNT function to return the number of inserted rows to the client application. Дополнительные сведения см. в статье @@ROWCOUNT (Transact-SQL).For more information, see @@ROWCOUNT (Transact-SQL).

Рекомендации по массовому импорту данныхBest Practices for Bulk Importing Data

Использование инструкции INSERT INTO…SELECT для массового импорта данных с минимальным протоколированиемUsing INSERT INTO...SELECT to Bulk Import Data with Minimal Logging

Инструкция INSERT INTO <target_table> SELECT <columns> FROM <source_table> может эффективно перенести большое количество строк из одной таблицы (например, промежуточной) в другую таблицу с минимальным протоколированием.You can use INSERT INTO <target_table> SELECT <columns> FROM <source_table> to efficiently transfer a large number of rows from one table, such as a staging table, to another table with minimal logging. Минимальное протоколирование может повысить производительность выполнения инструкции и снизить вероятность того, что во время операции будет заполнен весь журнал транзакций.Minimal logging can improve the performance of the statement and reduce the possibility of the operation filling the available transaction log space during the transaction.

Для минимального протоколирования этой инструкции необходимо выполнение следующих требований.Minimal logging for this statement has the following requirements:

  • Модель восстановления базы данных настроена на простое или неполное протоколирование.The recovery model of the database is set to simple or bulk-logged.

  • Целевой таблицей является пустая или непустая куча.The target table is an empty or nonempty heap.

  • Целевая таблица не используется в репликации.The target table is not used in replication.

  • Для целевой таблицы указана подсказка TABLOCK.The TABLOCK hint is specified for the target table.

Для строк, которые вставляются в кучу в результате действия вставки в инструкции MERGE, также может применяться минимальное протоколирование.Rows that are inserted into a heap as the result of an insert action in a MERGE statement may also be minimally logged.

В отличие от инструкции BULK INSERT, которая удерживает менее строгую блокировку массового обновления, инструкция INSERT INTO…SELECT с указанием TABLOCK удерживает монопольную блокировку (X) таблицы.Unlike the BULK INSERT statement, which holds a less restrictive Bulk Update lock, INSERT INTO...SELECT with the TABLOCK hint holds an exclusive (X) lock on the table. Это означает, что отсутствует возможность вставки строк с помощью параллельных операций вставки.This means that you cannot insert rows using parallel insert operations.

Использование предложений OPENROWSET и BULK для массового импорта данныхUsing OPENROWSET and BULK to Bulk Import Data

Функция OPENROWSET может принимать следующие табличные подсказки, обеспечивающие оптимизацию массовой загрузки с инструкцией INSERT.The OPENROWSET function can accept the following table hints, which provide bulk-load optimizations with the INSERT statement:

  • Использование подсказки TABLOCK может свести к минимуму число записей в журнале для операции вставки.The TABLOCK hint can minimize the number of log records for the insert operation. Для базы данных должна быть установлена простая модель восстановления или модель восстановления с неполным протоколированием. Кроме того, целевая таблица не может использоваться в репликации.The recovery model of the database must be set to simple or bulk-logged and the target table cannot be used in replication. Дополнительные сведения см. в разделе Предварительные условия для минимального протоколирования массового импорта данных.For more information, see Prerequisites for Minimal Logging in Bulk Import.

  • Проверку ограничений FOREIGN KEY и CHECK можно временно отключить с помощью подсказки IGNORE_CONSTRAINTS.The IGNORE_CONSTRAINTS hint can temporarily disable FOREIGN KEY and CHECK constraint checking.

  • Выполнение триггеров можно временно отключить с помощью подсказки IGNORE_TRIGGERS.The IGNORE_TRIGGERS hint can temporarily disable trigger execution.

  • Указание KEEPDEFAULTS позволяет вставить установленное по умолчанию значение столбца таблицы, если таковое имеется, вместо значения NULL, применяемого в случае, когда запись данных не содержит значения для этого столбца.The KEEPDEFAULTS hint allows the insertion of a table column's default value, if any, instead of NULL when the data record lacks a value for the column.

  • Подсказка KEEPIDENTITY позволяет использовать значения идентификаторов в файле импортированных данных для столбца идентификаторов в целевой таблице.The KEEPIDENTITY hint allows the identity values in the imported data file to be used for the identity column in the target table.

Эти оптимизации похожи на оптимизации, доступные для команды BULK INSERT.These optimizations are similar to those available with the BULK INSERT command. Дополнительные сведения см. в разделе Табличные указания (Transact-SQL).For more information, see Table Hints (Transact-SQL).

Типы данныхData Types

При вставке строк необходимо учитывать поведение следующих типов данных:When you insert rows, consider the following data type behavior:

  • Если значение загружается в столбцы с типом данных char, varchar и varbinary, то заполнение или усечение конечных пробелов (пробелы для char и varchar, нули для varbinary) определяется параметром SET ANSI_PADDING, определенным для столбца при создании таблицы.If a value is being loaded into columns with a char, varchar, or varbinary data type, the padding or truncation of trailing blanks (spaces for char and varchar, zeros for varbinary) is determined by the SET ANSI_PADDING setting defined for the column when the table was created. Дополнительные сведения см. в разделе SET ANSI_PADDING (Transact-SQL).For more information, see SET ANSI_PADDING (Transact-SQL).

    В следующей таблице показаны операции по умолчанию для параметра SET ANSI_PADDING, установленного в значение OFF.The following table shows the default operation for SET ANSI_PADDING OFF.

    Тип данныхData type Стандартная операцияDefault operation
    charchar Заполнение значения пробелами до заданной ширины столбца.Pad value with spaces to the defined width of column.
    varcharvarchar Удаление конечных пробелов до последнего непробельного символа или до одного пробела, если строка состоит только из пробелов.Remove trailing spaces to the last non-space character or to a single-space character for strings made up of only spaces.
    varbinaryvarbinary Удаление конечных нулей.Remove trailing zeros.
  • Если пустая строка (' ') загружена в столбец с типом данных varchar или text, то операцией по умолчанию будет загрузка строки нулевой длины.If an empty string (' ') is loaded into a column with a varchar or text data type, the default operation is to load a zero-length string.

  • Вставка значения NULL в столбец text или image не приводит ни к созданию допустимого текстового указателя, ни к предварительному распределению 8-килобайтной текстовой страницы.Inserting a null value into a text or image column does not create a valid text pointer, nor does it preallocate an 8-KB text page.

  • Столбцы, созданные с типом данных uniqueidentifier, содержат двоичные 16-байтные значения специального формата.Columns created with the uniqueidentifier data type store specially formatted 16-byte binary values. В отличие от столбцов идентификаторов Компонент Database EngineDatabase Engine не создает автоматически значения для столбцов с типом данных uniqueidentifier.Unlike with identity columns, the Компонент Database EngineDatabase Engine does not automatically generate values for columns with the uniqueidentifier data type. При вставке переменные с типом данных uniqueidentifier и константы строк в форме xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (36 символов, включая дефисы, где x является шестнадцатеричной цифрой в диапазоне 0–9 или a–f) могут быть использованы для столбцов uniqueidentifier.During an insert operation, variables with a data type of uniqueidentifier and string constants in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (36 characters including hyphens, where x is a hexadecimal digit in the range 0-9 or a-f) can be used for uniqueidentifier columns. Например, 6F9619FF-8B86-D011-B42D-00C04FC964FF является допустимым значением переменной или столбца uniqueidentifier.For example, 6F9619FF-8B86-D011-B42D-00C04FC964FF is a valid value for a uniqueidentifier variable or column. Используйте функцию NEWID() для получения идентификатора GUID.Use the NEWID() function to obtain a globally unique ID (GUID).

Вставка значений в столбцы определяемого пользователем типаInserting Values into User-Defined Type Columns

Вставлять значения в столбцы определяемого пользователем типа можно следующими способами.You can insert values in user-defined type columns by:

  • Предоставление значения определяемого пользователем типа.Supplying a value of the user-defined type.

  • Предоставление значения типа системных данных SQL ServerSQL Server происходит, если определяемый пользователем тип поддерживает явное или неявное преобразование из этого типа.Supplying a value in a SQL ServerSQL Server system data type, as long as the user-defined type supports implicit or explicit conversion from that type. В следующем примере показано, как вставляются значения из столбца определяемого пользователем типа Point путем явного преобразования из строки.The following example shows how to insert a value in a column of user-defined type Point, by explicitly converting from a string.

    INSERT INTO Cities (Location)  
    VALUES ( CONVERT(Point, '12.3:46.2') );  
    

    Двоичное значение также может предоставляться без выполнения явного преобразования, так как все определяемые пользователем типы могут быть неявно преобразованы из двоичного.A binary value can also be supplied without performing explicit conversion, because all user-defined types are implicitly convertible from binary.

  • Вызов определяемой пользователем функции, которая возвращает значение определяемого пользователем типа.Calling a user-defined function that returns a value of the user-defined type. В следующих примерах используется определяемая пользователем функция CreateNewPoint() для создания новых значений определяемого пользователем типа Point и вставки значения в таблицу Cities.The following example uses a user-defined function CreateNewPoint() to create a new value of user-defined type Point and insert the value into the Cities table.

    INSERT INTO Cities (Location)  
    VALUES ( dbo.CreateNewPoint(x, y) );  
    

Обработка ошибокError Handling

Для инструкции INSERT можно реализовать обработку ошибок, указав инструкцию в конструкции TRY…CATCH.You can implement error handling for the INSERT statement by specifying the statement in a TRY...CATCH construct.

Если инструкция INSERT нарушает ограничение или правило, либо в ней присутствует значение, несовместимое с типом данных столбца, то при выполнении инструкции происходит сбой и отображается сообщение об ошибке.If an INSERT statement violates a constraint or rule, or if it has a value incompatible with the data type of the column, the statement fails and an error message is returned.

Если инструкция INSERT загружает несколько строк с помощью инструкции SELECT или EXECUTE, то любые нарушения правил или ограничений, возникающие из-за загружаемых значений, приводят к остановке выполнения инструкции, и ни одна из строк не будет загружена.If INSERT is loading multiple rows with SELECT or EXECUTE, any violation of a rule or constraint that occurs from the values being loaded causes the statement to be stopped, and no rows are loaded.

Если при выполнении инструкции INSERT возникает арифметическая ошибка (переполнение, деление на ноль или ошибка домена), компонент Компонент Database EngineDatabase Engine обрабатывает эти ошибки так же, как если бы параметру SET ARITHABORT было присвоено значение ON.When an INSERT statement encounters an arithmetic error (overflow, divide by zero, or a domain error) occurring during expression evaluation, the Компонент Database EngineDatabase Engine handles these errors as if SET ARITHABORT is set to ON. Выполнение пакета прекращается и выводится сообщение об ошибке.The batch is stopped, and an error message is returned. Во время оценки выражения, когда параметры SET ARITHABORT и SET ANSI_WARNINGS установлены в значение OFF, если в инструкции INSERT, DELETE или UPDATE происходит арифметическая ошибка переполнения, деления на ноль или ошибка области определения, SQL ServerSQL Server вставляет или обновляет значение NULL.During expression evaluation when SET ARITHABORT and SET ANSI_WARNINGS are OFF, if an INSERT, DELETE or UPDATE statement encounters an arithmetic error, overflow, divide-by-zero, or a domain error, SQL ServerSQL Server inserts or updates a NULL value. Если целевой столбец не пустой, вставка или обновление не осуществляются, и пользователь получает ошибку.If the target column is not nullable, the insert or update action fails and the user receives an error.

СовместимостьInteroperability

Если триггер INSTEAD OF определен в операциях INSERT для таблицы или представления, то триггер выполняется вместо инструкции INSERT.When an INSTEAD OF trigger is defined on INSERT actions against a table or view, the trigger executes instead of the INSERT statement. Дополнительные сведения о триггерах INSTEAD OF см. в разделе CREATE TRIGGER (Transact-SQL).For more information about INSTEAD OF triggers, see CREATE TRIGGER (Transact-SQL).

ОграниченияLimitations and Restrictions

Если во время вставки значений в удаленные таблицы указаны не все значения для всех столбцов, то необходимо указать столбцы, в которые вставляются заданные значения.When you insert values into remote tables and not all values for all columns are specified, you must identify the columns to which the specified values are to be inserted.

При использовании выражения TOP в инструкции INSERT строки, на которые имеются ссылки, не упорядочиваются, а предложение ORDER BY не может быть прямо указано в этих инструкциях.When TOP is used with INSERT the referenced rows are not arranged in any order and the ORDER BY clause can not be directly specified in this statements. Если для вставки строк в значимом хронологическом порядке необходимо использовать предложение TOP, вместе с ним в инструкции подзапроса выборки следует использовать предложение ORDER BY.If you need to use TOP to insert rows in a meaningful chronological order, you must use TOP together with an ORDER BY clause that is specified in a subselect statement. См. подраздел «Примеры» далее в этом разделе.See the Examples section that follows in this topic.

Запросы INSERT, которые используют SELECT с ORDER BY для заполнения строк, гарантируют способ вычисления значений идентификатора, но не порядок вставки строк.INSERT queries that use SELECT with ORDER BY to populate rows guarantees how identity values are computed but not the order in which the rows are inserted.

В Parallel Data Warehouse предложение ORDER BY недопустимо в инструкциях VIEWS, CREATE TABLE AS SELECT, INSERT SELECT, встраиваемых функциях, производных таблицах, подзапросах и обобщенных табличных выражениях, если также не указать TOP.In Parallel Data Warehouse, the ORDER BY clause is invalid in VIEWS, CREATE TABLE AS SELECT, INSERT SELECT, inline functions, derived tables, subqueries and common table expressions, unless TOP is also specified.

Режим ведения журналаLogging Behavior

Инструкция INSERT всегда полностью регистрируется в журнале, кроме случаев использования функции OPENROWSET с ключевым словом BULK или выполнения инструкции INSERT INTO <target_table> SELECT <columns> FROM <source_table>.The INSERT statement is always fully logged except when using the OPENROWSET function with the BULK keyword or when using INSERT INTO <target_table> SELECT <columns> FROM <source_table>. Для этих операций возможно минимальное протоколирование.These operations can be minimally logged. Дополнительные сведения см. в подразделе «Рекомендации по массовой загрузке данных» этого раздела.For more information, see the section "Best Practices for Bulk Loading Data" earlier in this topic.

безопасностьSecurity

При соединении со связанным сервером отправляющий сервер указывает имя входа и пароль для подключения к принимающему серверу от его имени.During a linked server connection, the sending server provides a login name and password to connect to the receiving server on its behalf. Для работы этого соединения необходимо создать сопоставление имен входа между связанными серверами вызовом хранимой процедуры sp_addlinkedsrvlogin.For this connection to work, you must create a login mapping between the linked servers by using sp_addlinkedsrvlogin.

При использовании функции OPENROWSET(BULK…) важно понимать, каким образом SQL ServerSQL Server обрабатывает олицетворение.When you use OPENROWSET(BULK...), it is important to understand how SQL ServerSQL Server handles impersonation. Дополнительные сведения см. в главе "Вопросы безопасности" в разделе Массовый импорт данных при помощи инструкции BULK INSERT или OPENROWSET(BULK...) (SQL Server).For more information, see "Security Considerations" in Import Bulk Data by Using BULK INSERT or OPENROWSET(BULK...) (SQL Server).

РазрешенияPermissions

Требуется разрешение INSERT на целевую таблицу.INSERT permission is required on the target table.

Разрешения INSERT назначаются по умолчанию членам предопределенной роли сервера sysadmin, предопределенных ролей базы данных db_owner и db_datawriter, а также владельцу таблицы.INSERT permissions default to members of the sysadmin fixed server role, the db_owner and db_datawriter fixed database roles, and the table owner. Члены ролей sysadmin, db_owner и db_securityadmin, а также владелец таблицы могут передавать разрешения другим пользователям.Members of the sysadmin, db_owner, and the db_securityadmin roles, and the table owner can transfer permissions to other users.

Чтобы выполнить инструкцию INSERT с параметром BULK функции OPENROWSET, необходимо быть членом предопределенной роли сервера sysadmin или bulkadmin.To execute INSERT with the OPENROWSET function BULK option, you must be a member of the sysadmin fixed server role or of the bulkadmin fixed server role.

ПримерыExamples

КатегорияCategory Используемые элементы синтаксисаFeatured syntax elements
Основной синтаксисBasic syntax INSERT • конструктор табличных значенийINSERT • table value constructor
Обработка значений столбцаHandling column values IDENTITY • NEWID • значения по умолчанию • определяемые пользователем типыIDENTITY • NEWID • default values • user-defined types
Вставка данных из других таблицInserting data from other tables INSERT…SELECT • INSERT…EXECUTE • WITH обобщенное табличное выражение • TOP• OFFSET FETCHINSERT...SELECT • INSERT...EXECUTE • WITH common table expression • TOP • OFFSET FETCH
Указание целевых объектов, отличных от стандартных таблицSpecifying target objects other than standard tables Представления • табличные переменныеViews • table variables
Вставка строк в удаленную таблицуInserting rows into a remote table Связанный сервер • OPENQUERY, функция набора строк • OPENDATASOURCE, функция набора строкLinked server • OPENQUERY rowset function • OPENDATASOURCE rowset function
Массовая загрузка данных из таблиц или файлов данныхBulk loading data from tables or data files INSERT…SELECT • OPENROWSET, функцияINSERT...SELECT • OPENROWSET function
Переопределение поведения по умолчанию для оптимизатора запросов с помощью указанийOverriding the default behavior of the query optimizer by using hints Табличные указанияTable hints
Сбор результатов инструкции INSERTCapturing the results of the INSERT statement OUTPUT, предложениеOUTPUT clause

Базовый синтаксисBasic Syntax

В примерах в этом разделе описывается базовая функциональность инструкции INSERT с помощью минимального необходимого синтаксиса.Examples in this section demonstrate the basic functionality of the INSERT statement using the minimum required syntax.

A.A. Вставка одной строки данныхInserting a single row of data

В следующем примере показана вставка одной строки в таблицу Production.UnitMeasure базы данных AdventureWorks2012AdventureWorks2012.The following example inserts one row into the Production.UnitMeasure table in the AdventureWorks2012AdventureWorks2012 database. В этой таблице содержатся столбцы UnitMeasureCode, Name и ModifiedDate.The columns in this table are UnitMeasureCode, Name, and ModifiedDate. Так как значения для всех столбцов предоставлены и перечислены в том же порядке, что и столбцы в таблице, то не нужно указывать имена столбцов в списке столбцов .Because values for all columns are supplied and are listed in the same order as the columns in the table, the column names do not have to be specified in the column list .

INSERT INTO Production.UnitMeasure  
VALUES (N'FT', N'Feet', '20080414');  

Б.B. Вставка нескольких строк данныхInserting multiple rows of data

В следующем примере используется конструктор значений таблицы для вставки трех строк в таблицу Production.UnitMeasure базы данных AdventureWorks2012AdventureWorks2012 в единственной инструкции INSERT.The following example uses the table value constructor to insert three rows into the Production.UnitMeasure table in the AdventureWorks2012AdventureWorks2012 database in a single INSERT statement. Так как значения для всех столбцов предоставлены и перечислены в том же порядке, что и столбцы в таблице, то не нужно в параметре указывать имена столбцов.Because values for all columns are supplied and are listed in the same order as the columns in the table, the column names do not have to be specified in the column list.

INSERT INTO Production.UnitMeasure  
VALUES (N'FT2', N'Square Feet ', '20080923'), (N'Y', N'Yards', '20080923')
    , (N'Y3', N'Cubic Yards', '20080923');  

В.C. Вставка данных в порядке, отличном от порядка столбцов таблицыInserting data that is not in the same order as the table columns

В следующем примере используется список столбцов для явного указания значений, которые будут вставляться в каждый столбец.The following example uses a column list to explicitly specify the values that are inserted into each column. Порядок следования столбцов в таблице Production.UnitMeasure базы данных AdventureWorks2012AdventureWorks2012 является следующим: UnitMeasureCode, Name, ModifiedDate. Но в column_list столбцы перечислены в ином порядке.The column order in the Production.UnitMeasure table in the AdventureWorks2012AdventureWorks2012 database is UnitMeasureCode, Name, ModifiedDate; however, the columns are not listed in that order in column_list.

INSERT INTO Production.UnitMeasure (Name, UnitMeasureCode,  
    ModifiedDate)  
VALUES (N'Square Yards', N'Y2', GETDATE());  

Обработка значений столбцаHandling Column Values

Примеры в этом разделе описывают методы вставки значений в столбцы, которые определяются с помощью свойства IDENTITY, значения DEFAULT или с помощью типов данных, таких как uniqueidentifer или столбцов определяемого пользователем типа.Examples in this section demonstrate methods of inserting values into columns that are defined with an IDENTITY property, DEFAULT value, or are defined with data types such as uniqueidentifer or user-defined type columns.

Г.D. Вставка данных в таблицу со столбцами, имеющими значение по умолчаниюInserting data into a table with columns that have default values

В следующем примере показана вставка строк в таблицу со столбцами, для которых автоматически создается значение или которые имеют значение по умолчанию.The following example shows inserting rows into a table with columns that automatically generate a value or have a default value. Column_1 — это вычисляемый столбец, который автоматически создает значение, объединяя строку со значением, вставленным в столбец column_2.Column_1 is a computed column that automatically generates a value by concatenating a string with the value inserted into column_2. Столбец Column_2 определен с ограничением по умолчанию.Column_2 is defined with a default constraint. Если для этого столбца не указано значение, используется значение по умолчанию.If a value is not specified for this column, the default value is used. Столбец Column_3 имеет тип данных rowversion, который автоматически создает уникальное, последовательно увеличиваемое двоичное число.Column_3 is defined with the rowversion data type, which automatically generates a unique, incrementing binary number. Столбец Column_4 не формирует значения автоматически.Column_4 does not automatically generate a value. Если значение для этого столбца отсутствует, то вставляется значение NULL.When a value for this column is not specified, NULL is inserted. Инструкция INSERT вставляет строки, которые содержат значения для некоторых столбцов, но не для всех.The INSERT statements insert rows that contain values for some of the columns but not all. В последней инструкции INSERT столбцы не указаны, и поэтому вставляются только значения по умолчанию с помощью предложения DEFAULT VALUES.In the last INSERT statement, no columns are specified and only the default values are inserted by using the DEFAULT VALUES clause.

CREATE TABLE dbo.T1   
(  
    column_1 AS 'Computed column ' + column_2,   
    column_2 varchar(30)   
        CONSTRAINT default_name DEFAULT ('my column default'),  
    column_3 rowversion,  
    column_4 varchar(40) NULL  
);  
GO  
INSERT INTO dbo.T1 (column_4)   
    VALUES ('Explicit value');  
INSERT INTO dbo.T1 (column_2, column_4)   
    VALUES ('Explicit value', 'Explicit value');  
INSERT INTO dbo.T1 (column_2)   
    VALUES ('Explicit value');  
INSERT INTO T1 DEFAULT VALUES;   
GO  
SELECT column_1, column_2, column_3, column_4  
FROM dbo.T1;  
GO  

Д.E. Вставка данных в таблицу со столбцом идентификаторовInserting data into a table with an identity column

В следующем примере показаны различные методы вставки данных в столбец идентификаторов.The following example shows different methods of inserting data into an identity column. Первые две инструкции INSERT позволяют формировать значения идентификаторов для новых строк.The first two INSERT statements allow identity values to be generated for the new rows. Третья инструкция INSERT переопределяет свойство IDENTITY столбца с помощью инструкции SET IDENTITY_INSERT и вставляет явно заданное значение в столбец идентификаторов.The third INSERT statement overrides the IDENTITY property for the column with the SET IDENTITY_INSERT statement and inserts an explicit value into the identity column.

CREATE TABLE dbo.T1 ( column_1 int IDENTITY, column_2 VARCHAR(30));  
GO  
INSERT T1 VALUES ('Row #1');  
INSERT T1 (column_2) VALUES ('Row #2');  
GO  
SET IDENTITY_INSERT T1 ON;  
GO  
INSERT INTO T1 (column_1,column_2)   
    VALUES (-99, 'Explicit identity value');  
GO  
SELECT column_1, column_2  
FROM T1;  
GO  

Е.F. Вставка данных в столбец типа uniqueidentifier с помощью функции NEWID()Inserting data into a uniqueidentifier column by using NEWID()

В следующем примере функция NEWID() вызывается для вставки идентификатора GUID в столбец column_2.The following example uses the NEWID() function to obtain a GUID for column_2. В отличие от столбцов идентификаторов, компонент Компонент Database EngineDatabase Engine не создает автоматически значения для столбцов с типом данных uniqueidentifier, как показано во второй инструкции INSERT.Unlike for identity columns, the Компонент Database EngineDatabase Engine does not automatically generate values for columns with the uniqueidentifier data type, as shown by the second INSERT statement.

CREATE TABLE dbo.T1   
(  
    column_1 int IDENTITY,   
    column_2 uniqueidentifier,  
);  
GO  
INSERT INTO dbo.T1 (column_2)   
    VALUES (NEWID());  
INSERT INTO T1 DEFAULT VALUES;   
GO  
SELECT column_1, column_2  
FROM dbo.T1;  
  

Ж.G. Вставка данных в столбцы определяемого пользователем типаInserting data into user-defined type columns

Следующие инструкции Transact-SQLTransact-SQL вставляют три строки в столбец PointValue таблицы Points.The following Transact-SQLTransact-SQL statements insert three rows into the PointValue column of the Points table. Этот столбец имеет определяемый пользователем тип данных CLR.This column uses a CLR user-defined type (UDT). Тип данных Point состоит из целочисленных значений X и Y, которые представлены как свойства определяемого пользователем типа.The Point data type consists of X and Y integer values that are exposed as properties of the UDT. Необходимо привести разделяемые запятой значения X и Y к типу Point с помощью функции CAST или CONVERT.You must use either the CAST or CONVERT function to cast the comma-delimited X and Y values to the Point type. Первые две инструкции используют функцию CONVERT для преобразования строкового значения в тип Point, а третья инструкция использует функцию CAST.The first two statements use the CONVERT function to convert a string value to the Point type, and the third statement uses the CAST function. Дополнительные сведения см. в разделе Работа с данными определяемого пользователем типа.For more information, see Manipulating UDT Data.

INSERT INTO dbo.Points (PointValue) VALUES (CONVERT(Point, '3,4'));  
INSERT INTO dbo.Points (PointValue) VALUES (CONVERT(Point, '1,5'));  
INSERT INTO dbo.Points (PointValue) VALUES (CAST ('1,99' AS Point));  

Вставка данных из других таблицInserting Data from Other Tables

В примерах этого раздела показаны методы вставки строк из одной таблицы в другую.Examples in this section demonstrate methods of inserting rows from one table into another table.

З.H. Вставка данных из других таблиц с помощью параметров SELECT и EXECUTEUsing the SELECT and EXECUTE options to insert data from other tables

В следующем примере описана вставка данных из одной таблицы в другую с помощью инструкций INSERT…SELECT и INSERT…EXECUTE.The following example shows how to insert data from one table into another table by using INSERT...SELECT or INSERT...EXECUTE. Каждый метод основан на многотабличной инструкции SELECT, содержащей выражение и литеральное значение в списке столбцов.Each is based on a multi-table SELECT statement that includes an expression and a literal value in the column list.

В первой инструкции INSERT используется инструкция SELECT для получения данных из исходных таблиц (Employee, SalesPerson и Person) в базе данных AdventureWorks2012AdventureWorks2012 и сохранения результирующего набора в таблице EmployeeSales.The first INSERT statement uses a SELECT statement to derive the data from the source tables (Employee, SalesPerson, and Person) in the AdventureWorks2012AdventureWorks2012 database and store the result set in the EmployeeSales table. Вторая инструкция INSERT с помощью предложения EXECUTE вызывает хранимую процедуру, содержащую инструкцию SELECT, а третья инструкция INSERT с помощью предложения EXECUTE ссылается на инструкцию SELECT как на символьную строку.The second INSERT statement uses the EXECUTE clause to call a stored procedure that contains the SELECT statement, and the third INSERT uses the EXECUTE clause to reference the SELECT statement as a literal string.

CREATE TABLE dbo.EmployeeSales  
( DataSource   varchar(20) NOT NULL,  
  BusinessEntityID   varchar(11) NOT NULL,  
  LastName     varchar(40) NOT NULL,  
  SalesDollars money NOT NULL  
);  
GO  
CREATE PROCEDURE dbo.uspGetEmployeeSales   
AS   
    SET NOCOUNT ON;  
    SELECT 'PROCEDURE', sp.BusinessEntityID, c.LastName,   
        sp.SalesYTD   
    FROM Sales.SalesPerson AS sp    
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE '2%'  
    ORDER BY sp.BusinessEntityID, c.LastName;  
GO  
--INSERT...SELECT example  
INSERT INTO dbo.EmployeeSales  
    SELECT 'SELECT', sp.BusinessEntityID, c.LastName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE '2%'  
    ORDER BY sp.BusinessEntityID, c.LastName;  
GO  
--INSERT...EXECUTE procedure example  
INSERT INTO dbo.EmployeeSales   
EXECUTE dbo.uspGetEmployeeSales;  
GO  
--INSERT...EXECUTE('string') example  
INSERT INTO dbo.EmployeeSales   
EXECUTE   
('  
SELECT ''EXEC STRING'', sp.BusinessEntityID, c.LastName,   
    sp.SalesYTD   
    FROM Sales.SalesPerson AS sp   
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE ''2%''  
    ORDER BY sp.BusinessEntityID, c.LastName  
');  
GO  
--Show results.  
SELECT DataSource,BusinessEntityID,LastName,SalesDollars  
FROM dbo.EmployeeSales;  

И.I. Использование обобщенного табличного выражения WITH для определения вставляемых данныхUsing WITH common table expression to define the data inserted

В следующем примере создается таблица NewEmployee в базе данных AdventureWorks2012AdventureWorks2012.The following example creates the NewEmployee table in the AdventureWorks2012AdventureWorks2012 database. Обобщенное табличное выражение (EmployeeTemp) определяет строки из одной или нескольких таблиц, которые вставляются в таблицу NewEmployee.A common table expression (EmployeeTemp) defines the rows from one or more tables to be inserted into the NewEmployee table. Инструкция INSERT ссылается на столбцы в обобщенном табличном выражении.The INSERT statement references the columns in the common table expression.

CREATE TABLE HumanResources.NewEmployee  
(  
    EmployeeID int NOT NULL,  
    LastName nvarchar(50) NOT NULL,  
    FirstName nvarchar(50) NOT NULL,  
    PhoneNumber Phone NULL,  
    AddressLine1 nvarchar(60) NOT NULL,  
    City nvarchar(30) NOT NULL,  
    State nchar(3) NOT NULL,   
    PostalCode nvarchar(15) NOT NULL,  
    CurrentFlag Flag  
);  
GO  
WITH EmployeeTemp (EmpID, LastName, FirstName, Phone,   
                   Address, City, StateProvince,   
                   PostalCode, CurrentFlag)  
AS (SELECT   
       e.BusinessEntityID, c.LastName, c.FirstName, pp.PhoneNumber,  
       a.AddressLine1, a.City, sp.StateProvinceCode,   
       a.PostalCode, e.CurrentFlag  
    FROM HumanResources.Employee e  
        INNER JOIN Person.BusinessEntityAddress AS bea  
        ON e.BusinessEntityID = bea.BusinessEntityID  
        INNER JOIN Person.Address AS a  
        ON bea.AddressID = a.AddressID  
        INNER JOIN Person.PersonPhone AS pp  
        ON e.BusinessEntityID = pp.BusinessEntityID  
        INNER JOIN Person.StateProvince AS sp  
        ON a.StateProvinceID = sp.StateProvinceID  
        INNER JOIN Person.Person as c  
        ON e.BusinessEntityID = c.BusinessEntityID  
    )  
INSERT INTO HumanResources.NewEmployee   
    SELECT EmpID, LastName, FirstName, Phone,   
           Address, City, StateProvince, PostalCode, CurrentFlag  
    FROM EmployeeTemp;  
GO  

К.J. Использование TOP для ограничения данных, вставляемых из исходной таблицыUsing TOP to limit the data inserted from the source table

В следующем примере создается таблица EmployeeSales и выполняется вставка данных о продажах за текущий год для пяти первых случайно выбранных сотрудников из таблицы HumanResources.Employee в базу данных AdventureWorks2012AdventureWorks2012.The following example creates the table EmployeeSales and inserts the name and year-to-date sales data for the top 5 random employees from the table HumanResources.Employee in the AdventureWorks2012AdventureWorks2012 database. Инструкция INSERT выбирает любые пять строк из строк, возвращенных инструкцией SELECT.The INSERT statement chooses any 5 rows returned by the SELECT statement. Предложение OUTPUT отображает строки, вставляемые в таблицу EmployeeSales.The OUTPUT clause displays the rows that are inserted into the EmployeeSales table. Обратите внимание, что предложение ORDER BY в инструкции SELECT не используется для определения 5 наиболее успешных сотрудников.Notice that the ORDER BY clause in the SELECT statement is not used to determine the top 5 employees.

CREATE TABLE dbo.EmployeeSales  
( EmployeeID   nvarchar(11) NOT NULL,  
  LastName     nvarchar(20) NOT NULL,  
  FirstName    nvarchar(20) NOT NULL,  
  YearlySales  money NOT NULL  
 );  
GO  
INSERT TOP(5)INTO dbo.EmployeeSales  
    OUTPUT inserted.EmployeeID, inserted.FirstName, 
        inserted.LastName, inserted.YearlySales  
    SELECT sp.BusinessEntityID, c.LastName, c.FirstName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.SalesYTD > 250000.00  
    ORDER BY sp.SalesYTD DESC;  

Если для вставки строк в значимом хронологическом порядке решено использовать предложение TOP, вместе с ним в инструкции подзапроса выборки следует использовать предложение ORDER BY, как показано в следующем примере.If you have to use TOP to insert rows in a meaningful chronological order, you must use TOP together with ORDER BY in a subselect statement as shown in the following example. Предложение OUTPUT отображает строки, вставляемые в таблицу EmployeeSales.The OUTPUT clause displays the rows that are inserted into the EmployeeSales table. Обратите внимание, что вставка данных 5 наиболее успешных сотрудников выполняется на основе результатов предложения ORDER BY, а не случайных строк.Notice that the top 5 employees are now inserted based on the results of the ORDER BY clause instead of random rows.

INSERT INTO dbo.EmployeeSales  
    OUTPUT inserted.EmployeeID, inserted.FirstName, 
        inserted.LastName, inserted.YearlySales  
    SELECT TOP (5) sp.BusinessEntityID, c.LastName, c.FirstName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.SalesYTD > 250000.00  
    ORDER BY sp.SalesYTD DESC;  

Указание целевых объектов, отличных от стандартных таблицSpecifying Target Objects Other Than Standard Tables

В примерах этого раздела показаны методы вставки строк с указанием представления или табличной переменной.Examples in this section demonstrate how to insert rows by specifying a view or table variable.

Л.K. Вставка данных с указанием представленияInserting data by specifying a view

В следующем примере в качестве целевого объекта указано имя представления; новая строка вставляется в базовую таблицу.The following example specifies a view name as the target object; however, the new row is inserted in the underlying base table. Порядок следования значений в инструкции INSERT должен совпадать с порядком следования столбцов в представлении.The order of the values in the INSERT statement must match the column order of the view. Дополнительные сведения см. в разделе Изменение данных через представление.For more information, see Modify Data Through a View.

CREATE TABLE T1 ( column_1 int, column_2 varchar(30));  
GO  
CREATE VIEW V1 AS   
SELECT column_2, column_1   
FROM T1;  
GO  
INSERT INTO V1   
    VALUES ('Row 1',1);  
GO  
SELECT column_1, column_2   
FROM T1;  
GO  
SELECT column_1, column_2  
FROM V1;  
GO  

М.L. Вставка данных в табличную переменнуюInserting data into a table variable

В следующем примере задается переменная таблицы в качестве целевого объекта в базе данных AdventureWorks2012AdventureWorks2012.The following example specifies a table variable as the target object in the AdventureWorks2012AdventureWorks2012 database.

-- Create the table variable.  
DECLARE @MyTableVar table(  
    LocationID int NOT NULL,  
    CostRate smallmoney NOT NULL,  
    NewCostRate AS CostRate * 1.5,  
    ModifiedDate datetime);  
  
-- Insert values into the table variable.  
INSERT INTO @MyTableVar (LocationID, CostRate, ModifiedDate)  
    SELECT LocationID, CostRate, GETDATE() 
    FROM Production.Location  
    WHERE CostRate > 0;  
  
-- View the table variable result set.  
SELECT * FROM @MyTableVar;  
GO  

Вставка строк в удаленную таблицуInserting Rows into a Remote Table

В примерах в этом разделе описаны способы вставки в удаленную целевую таблицу с использованием в качестве ссылки на удаленную таблицу связанного сервера или функции, возвращающей набор строк.Examples in this section demonstrate how to insert rows into a remote target table by using a linked server or a rowset function to reference the remote table.

Н.M. Вставка данных в удаленную таблицу с использованием связанного сервераInserting data into a remote table by using a linked server

В следующем примере в удаленную таблицу вставляются строки.The following example inserts rows into a remote table. Этот пример начинается с создания ссылки на удаленный источник данных с помощью хранимой процедуры sp_addlinkedserver.The example begins by creating a link to the remote data source by using sp_addlinkedserver. Имя связанного сервера, MyLinkServer, затем определяется как часть четырехчастного имени объекта в форме server.catalog.schema.object.The linked server name, MyLinkServer, is then specified as part of the four-part object name in the form server.catalog.schema.object.

Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

USE master;  
GO  
-- Create a link to the remote data source.   
-- Specify a valid server name for @datasrc as 'server_name' 
-- or 'server_nameinstance_name'.  
  
EXEC sp_addlinkedserver @server = N'MyLinkServer',  
    @srvproduct = N' ',  
    @provider = N'SQLNCLI',   
    @datasrc = N'server_name',  
    @catalog = N'AdventureWorks2012';  
GO  
-- Specify the remote data source in the FROM clause using a four-part name   
-- in the form linked_server.catalog.schema.object.  
  
INSERT INTO MyLinkServer.AdventureWorks2012.HumanResources.Department (Name, GroupName)  
VALUES (N'Public Relations', N'Executive General and Administration');  
GO  

О.N. Вставка данных в удаленную таблицу с помощью функции OPENQUERYInserting data into a remote table by using the OPENQUERY function

В следующем примере выполняется вставка строки в удаленную таблицу с помощью вызова функции OPENQUERY, возвращающей набор строк.The following example inserts a row into a remote table by specifying the OPENQUERY rowset function. В этом примере используется имя связанного сервера, созданного в предыдущем примере.The linked server name created in the previous example is used in this example.

Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

INSERT OPENQUERY (MyLinkServer, 
    'SELECT Name, GroupName 
     FROM AdventureWorks2012.HumanResources.Department')  
VALUES ('Environmental Impact', 'Engineering');  
GO  

П.O. Вставка данных в удаленную таблицу с помощью функции OPENDATASOURCEInserting data into a remote table by using the OPENDATASOURCE function

В следующем примере выполняется вставка строки в удаленную таблицу с помощью вызова функции OPENDATASOURCE, возвращающей набор строк.The following example inserts a row into a remote table by specifying the OPENDATASOURCE rowset function. Определите допустимое имя сервера для источника данных, используя формат server_name или server_name\instance_name.Specify a valid server name for the data source by using the format server_name or server_name\instance_name.

Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

-- Use the OPENDATASOURCE function to specify the remote data source.  
-- Specify a valid server name for Data Source using the format 
-- server_name or server_nameinstance_name.  
  
INSERT INTO OPENDATASOURCE('SQLNCLI',  
    'Data Source= <server_name>; Integrated Security=SSPI')  
    .AdventureWorks2012.HumanResources.Department (Name, GroupName)  
    VALUES (N'Standards and Methods', 'Quality Assurance');  
GO  

Т.P. Вставка во внешнюю таблицу, созданную с помощью PolyBaseInserting into an external table created using PolyBase

Вы можете экспортировать данные из SQL Server в службу хранилища Azure или Hadoop.Export data from SQL Server to Hadoop or Azure Storage. Для этого сначала необходимо создать внешнюю таблицу, которая указывает на целевой файл или каталог.First, create an external table that points to the destination file or directory. Затем используйте инструкцию INSERT INTO, чтобы экспортировать данные из локальной таблицы SQL Server во внешний источник данных.Then, use INSERT INTO to export data from a local SQL Server table to an external data source. При выполнении инструкции INSERT INTO создается целевой файл или каталог (если его не существует), а результаты выполнения инструкции SELECT экспортируются в указанное расположение в заданном формате.The INSERT INTO statement creates the destination file or directory if it does not exist and the results of the SELECT statement are exported to the specified location in the specified file format. Дополнительные сведения см. в разделе Приступая к работе с PolyBase.For more information, see Get started with PolyBase.

Применимо к: SQL ServerSQL Server.Applies to: SQL ServerSQL Server.

-- Create an external table.   
CREATE EXTERNAL TABLE [dbo].[FastCustomers2009] (  
        [FirstName] char(25) NOT NULL,   
        [LastName] char(25) NOT NULL,   
        [YearlyIncome] float NULL,   
        [MaritalStatus] char(1) NOT NULL  
)  
WITH (  
        LOCATION='/old_data/2009/customerdata.tbl',  
        DATA_SOURCE = HadoopHDP2,  
        FILE_FORMAT = TextFileFormat,  
        REJECT_TYPE = VALUE,  
        REJECT_VALUE = 0  
);  
  
-- Export data: Move old data to Hadoop while keeping 
-- it query-able via external table.  

INSERT INTO dbo.FastCustomer2009  
SELECT T.* FROM Insured_Customers T1 JOIN CarSensor_Data T2  
ON (T1.CustomerKey = T2.CustomerKey)  
WHERE T2.YearMeasured = 2009 and T2.Speed > 40;  

Массовая загрузка данных из таблиц или файлов данныхBulk Loading Data from Tables or Data Files

В примерах этого раздела показано два метода массовой загрузки данных в таблицу с помощью инструкции INSERT.Examples in this section demonstrate two methods to bulk load data into a table by using the INSERT statement.

У.Q. Вставка данных в кучу с минимальным протоколированиемInserting data into a heap with minimal logging

В следующем примере создается таблица (куча), в которую вставляются данные из другой таблицы с минимальным протоколированием.The following example creates a new table (a heap) and inserts data from another table into it using minimal logging. В примере предполагается, что для базы данных AdventureWorks2012 выбрана модель восстановления FULL.The example assumes that the recovery model of the AdventureWorks2012 database is set to FULL. Чтобы убедиться, что применяется минимальное протоколирование, модель восстановления базы данных AdventureWorks2012 перед вставкой строк устанавливается в значение BULK_LOGGED, а после выполнения инструкции INSERT INTO… SELECT возвращается в значение FULL.To ensure minimal logging is used, the recovery model of the AdventureWorks2012 database is set to BULK_LOGGED before rows are inserted and reset to FULL after the INSERT INTO...SELECT statement. Кроме того, для целевой таблицы Sales.SalesHistory указывается подсказка TABLOCK.In addition, the TABLOCK hint is specified for the target table Sales.SalesHistory. Это обеспечивает минимальное использование журнала транзакций инструкцией и ее эффективное выполнение.This ensures that the statement uses minimal space in the transaction log and performs efficiently.

-- Create the target heap.  
CREATE TABLE Sales.SalesHistory(  
    SalesOrderID int NOT NULL,  
    SalesOrderDetailID int NOT NULL,  
    CarrierTrackingNumber nvarchar(25) NULL,  
    OrderQty smallint NOT NULL,  
    ProductID int NOT NULL,  
    SpecialOfferID int NOT NULL,  
    UnitPrice money NOT NULL,  
    UnitPriceDiscount money NOT NULL,  
    LineTotal money NOT NULL,  
    rowguid uniqueidentifier ROWGUIDCOL  NOT NULL,  
    ModifiedDate datetime NOT NULL );  
GO  
-- Temporarily set the recovery model to BULK_LOGGED.  
ALTER DATABASE AdventureWorks2012  
SET RECOVERY BULK_LOGGED;  
GO  
-- Transfer data from Sales.SalesOrderDetail to Sales.SalesHistory  
INSERT INTO Sales.SalesHistory WITH (TABLOCK)  
    (SalesOrderID,   
     SalesOrderDetailID,  
     CarrierTrackingNumber,   
     OrderQty,   
     ProductID,   
     SpecialOfferID,   
     UnitPrice,   
     UnitPriceDiscount,  
     LineTotal,   
     rowguid,   
     ModifiedDate)  
SELECT * FROM Sales.SalesOrderDetail;  
GO  
-- Reset the recovery model.  
ALTER DATABASE AdventureWorks2012  
SET RECOVERY FULL;  
GO  

Ф.R. Использование функции OPENROWSET с параметром BULK для массовой загрузки данных а таблицуUsing the OPENROWSET function with BULK to bulk load data into a table

В следующем примере выполняется вставка строки в таблицу из файла данных вызовом функции OPENQUERY.The following example inserts rows from a data file into a table by specifying the OPENROWSET function. Для оптимизации производительности указывается табличная подсказка IGNORE_TRIGGERS.The IGNORE_TRIGGERS table hint is specified for performance optimization. Дополнительные примеры см. в разделе Массовый импорт данных при помощи инструкции BULK INSERT или OPENROWSET(BULK...) (SQL Server).For more examples, see Import Bulk Data by Using BULK INSERT or OPENROWSET(BULK...) (SQL Server).

Область применения: SQL Server 2008SQL Server 2008 и более поздних версий.Applies to: SQL Server 2008SQL Server 2008 and later.

INSERT INTO HumanResources.Department WITH (IGNORE_TRIGGERS) (Name, GroupName)  
SELECT b.Name, b.GroupName   
FROM OPENROWSET (  
    BULK 'C:SQLFilesDepartmentData.txt',  
    FORMATFILE = 'C:SQLFilesBulkloadFormatFile.xml',  
    ROWS_PER_BATCH = 15000)AS b ;  

Переопределение поведения по умолчанию для оптимизатора запросов с помощью указанийOverriding the Default Behavior of the Query Optimizer by Using Hints

Примеры в этом разделе описывают использование табличных указаний для временного переопределения поведения оптимизатора запросов при обработке инструкции INSERT.Examples in this section demonstrate how to use table hints to temporarily override the default behavior of the query optimizer when processing the INSERT statement.

Внимание!

Поскольку оптимизатор запросов SQL ServerSQL Server обычно выбирает наилучший план выполнения запроса, подсказки рекомендуется использовать только опытным разработчикам и администраторам баз данных в качестве последнего средства.Because the SQL ServerSQL Server query optimizer typically selects the best execution plan for a query, we recommend that hints be used only as a last resort by experienced developers and database administrators.

Х.S. Использование подсказки TABLOCK для указания метода блокировкиUsing the TABLOCK hint to specify a locking method

В следующем примере показано, как монопольная блокировка (Х) применяется к таблице Production.Location и сохраняется до завершения инструкции UPDATE.The following example specifies that an exclusive (X) lock is taken on the Production.Location table and is held until the end of the INSERT statement.

Применимо к: SQL ServerSQL Server, База данных SQLSQL Database.Applies to: SQL ServerSQL Server, База данных SQLSQL Database.

INSERT INTO Production.Location WITH (XLOCK)  
(Name, CostRate, Availability)  
VALUES ( N'Final Inventory', 15.00, 80.00);  

Сбор результатов инструкции INSERTCapturing the Results of the INSERT Statement

Примеры в этом разделе описывают использование предложения OUTPUT для возврата данных для всех строк, изменившихся в результате выполнения инструкции INSERT, либо выражений на основе этих данных.Examples in this section demonstrate how to use the OUTPUT Clause to return information from, or expressions based on, each row affected by an INSERT statement. Эти результаты могут быть возвращены приложению, например для вывода подтверждающих сообщений, архивирования и т. п.These results can be returned to the processing application for use in such things as confirmation messages, archiving, and other such application requirements.

T.T. Использование предложения OUTPUT с инструкцией INSERTUsing OUTPUT with an INSERT statement

В следующем примере производится вставка строки в таблицу ScrapReason, а затем при помощи предложения OUTPUT результаты выполнения инструкции возвращаются в табличную переменную @MyTableVar.The following example inserts a row into the ScrapReason table and uses the OUTPUT clause to return the results of the statement to the @MyTableVar table variable. Так как столбец ScrapReasonID определен с помощью свойства IDENTITY, то значение для этого столбца не указано в инструкции INSERT.Because the ScrapReasonID column is defined with an IDENTITY property, a value is not specified in the INSERT statement for that column. Однако следует заметить, что значение, созданное компонентом Компонент Database EngineDatabase Engine для этого столбца, возвращается в предложении OUTPUT в столбец INSERTED.ScrapReasonID.However, note that the value generated by the Компонент Database EngineDatabase Engine for that column is returned in the OUTPUT clause in the INSERTED.ScrapReasonID column.

DECLARE @MyTableVar table( NewScrapReasonID smallint,  
                           Name varchar(50),  
                           ModifiedDate datetime);  
INSERT Production.ScrapReason  
    OUTPUT INSERTED.ScrapReasonID, INSERTED.Name, INSERTED.ModifiedDate  
        INTO @MyTableVar  
VALUES (N'Operator error', GETDATE());  
  
--Display the result set of the table variable.  
SELECT NewScrapReasonID, Name, ModifiedDate FROM @MyTableVar;  
--Display the result set of the table.  
SELECT ScrapReasonID, Name, ModifiedDate   
FROM Production.ScrapReason;  

Ф.U. Применение предложения OUTPUT со столбцами идентификаторов и вычисляемыми столбцамиUsing OUTPUT with identity and computed columns

В следующем примере создается таблица EmployeeSales, а затем в нее с помощью инструкции INSERT вставляется несколько строк, получаемых инструкцией SELECT из исходных таблиц.The following example creates the EmployeeSales table and then inserts several rows into it using an INSERT statement with a SELECT statement to retrieve data from source tables. Таблица EmployeeSales содержит столбец идентификаторов (EmployeeID) и вычисляемый столбец (ProjectedSales).The EmployeeSales table contains an identity column (EmployeeID) and a computed column (ProjectedSales). Поскольку значения создаются компонентом Компонент Database EngineDatabase Engine при вставке, ни один из этих столбцов не может быть определен в @MyTableVar.Because these values are generated by the Компонент Database EngineDatabase Engine during the insert operation, neither of these columns can be defined in @MyTableVar.

CREATE TABLE dbo.EmployeeSales  
( EmployeeID   int IDENTITY (1,5)NOT NULL,  
  LastName     nvarchar(20) NOT NULL,  
  FirstName    nvarchar(20) NOT NULL,  
  CurrentSales money NOT NULL,  
  ProjectedSales AS CurrentSales * 1.10   
);  
GO  
DECLARE @MyTableVar table(  
  LastName     nvarchar(20) NOT NULL,  
  FirstName    nvarchar(20) NOT NULL,  
  CurrentSales money NOT NULL  
  );  
  
INSERT INTO dbo.EmployeeSales (LastName, FirstName, CurrentSales)  
  OUTPUT INSERTED.LastName,   
         INSERTED.FirstName,   
         INSERTED.CurrentSales  
  INTO @MyTableVar  
    SELECT c.LastName, c.FirstName, sp.SalesYTD  
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE '2%'  
    ORDER BY c.LastName, c.FirstName;  
  
SELECT LastName, FirstName, CurrentSales  
FROM @MyTableVar;  
GO  
SELECT EmployeeID, LastName, FirstName, CurrentSales, ProjectedSales  
FROM dbo.EmployeeSales;  

Х.V. Вставка данных, возвращенных предложением OUTPUTInserting data returned from an OUTPUT clause

В следующем примере производится отслеживание данных, возвращаемых предложением OUTPUT инструкции MERGE, а затем производится вставка этих данных в другую таблицу.The following example captures data returned from the OUTPUT clause of a MERGE statement, and inserts that data into another table. В инструкции MERGE ежедневно обновляется столбец Quantity таблицы ProductInventory на основе заказов, обработанных в таблице SalesOrderDetail базы данных AdventureWorks2012AdventureWorks2012.The MERGE statement updates the Quantity column of the ProductInventory table daily, based on orders that are processed in the SalesOrderDetail table in the AdventureWorks2012AdventureWorks2012 database. Инструкция также удаляет строки с продуктами, запас которых сократился до 0.It also deletes rows for products whose inventories drop to 0. В примере собираются удаленные строки и вставляются в другую таблицу, ZeroInventory, в которой ведется учет закончившихся продуктов.The example captures the rows that are deleted and inserts them into another table, ZeroInventory, which tracks products with no inventory.

--Create ZeroInventory table.  
CREATE TABLE Production.ZeroInventory (DeletedProductID int, RemovedOnDate DateTime);  
GO  
  
INSERT INTO Production.ZeroInventory (DeletedProductID, RemovedOnDate)  
SELECT ProductID, GETDATE()  
FROM  
(   MERGE Production.ProductInventory AS pi  
    USING (SELECT ProductID, SUM(OrderQty) FROM Sales.SalesOrderDetail AS sod  
           JOIN Sales.SalesOrderHeader AS soh  
           ON sod.SalesOrderID = soh.SalesOrderID  
           AND soh.OrderDate = '20070401'  
           GROUP BY ProductID) AS src (ProductID, OrderQty)  
    ON (pi.ProductID = src.ProductID)  
    WHEN MATCHED AND pi.Quantity - src.OrderQty <= 0  
        THEN DELETE  
    WHEN MATCHED  
        THEN UPDATE SET pi.Quantity = pi.Quantity - src.OrderQty  
    OUTPUT $action, deleted.ProductID) AS Changes (Action, ProductID)  
WHERE Action = 'DELETE';  
IF @@ROWCOUNT = 0  
PRINT 'Warning: No rows were inserted';  
GO  
SELECT DeletedProductID, RemovedOnDate FROM Production.ZeroInventory;  

Ц.W. Вставка данных с помощью параметра SELECTInserting data using the SELECT option

В следующем примере показано, как вставить несколько строк данных с помощью инструкции INSERT с параметром SELECT.The following example shows how to insert multiple rows of data using an INSERT statement with a SELECT option. Первая инструкция INSERT напрямую использует инструкцию SELECT для получения данных из исходной таблицы и сохранения результирующего набора в таблице EmployeeTitles.The first INSERT statement uses a SELECT statement directly to retrieve data from the source table, and then to store the result set in the EmployeeTitles table.

CREATE TABLE EmployeeTitles  
( EmployeeKey   INT NOT NULL,  
  LastName     varchar(40) NOT NULL,  
  Title      varchar(50) NOT NULL  
);  
INSERT INTO EmployeeTitles  
    SELECT EmployeeKey, LastName, Title   
    FROM ssawPDW.dbo.DimEmployee  
    WHERE EndDate IS NULL;  

X.X. Указание метки с инструкцией INSERTSpecifying a label with the INSERT statement

В следующем примере показано использование метки с инструкцией INSERT.The following example shows the use of a label with an INSERT statement.

-- Uses AdventureWorks  
  
INSERT INTO DimCurrency   
VALUES (500, N'C1', N'Currency1')  
OPTION ( LABEL = N'label1' );  

Ш.Y. Использование метки и указания запроса с инструкцией INSERTUsing a label and a query hint with the INSERT statement

Этот запрос показывает базовый синтаксис для использования метки и указания на соединение с запросом с инструкцией INSERT.This query shows the basic syntax for using a label and a query join hint with the INSERT statement. После отправки запроса к узлу управления SQL ServerSQL Server, выполняющемуся на вычислительных узлах, будет применена стратегия хэш-соединения при создании плана запроса SQL ServerSQL Server.After the query is submitted to the Control node, SQL ServerSQL Server, running on the Compute nodes, will apply the hash join strategy when it generates the SQL ServerSQL Server query plan. Дополнительные сведения об указаниях по соединению и использованию предложения OPTION см. в разделе OPTION (SQL Server PDW).For more information on join hints and how to use the OPTION clause, see OPTION (SQL Server PDW).

-- Uses AdventureWorks  
  
INSERT INTO DimCustomer (CustomerKey, CustomerAlternateKey, 
    FirstName, MiddleName, LastName )   
SELECT ProspectiveBuyerKey, ProspectAlternateKey, 
    FirstName, MiddleName, LastName  
FROM ProspectiveBuyer p JOIN DimGeography g ON p.PostalCode = g.PostalCode  
WHERE g.CountryRegionCode = 'FR'  
OPTION ( LABEL = 'Add French Prospects', HASH JOIN);  

См. также:See Also

BULK INSERT (Transact-SQL) BULK INSERT (Transact-SQL)
DELETE (Transact-SQL) DELETE (Transact-SQL)
EXECUTE (Transact-SQL) EXECUTE (Transact-SQL)
FROM (Transact-SQL) FROM (Transact-SQL)
Свойство IDENTITY (Transact-SQL) IDENTITY (Property) (Transact-SQL)
NEWID (Transact-SQL) NEWID (Transact-SQL)
SELECT (Transact-SQL) SELECT (Transact-SQL)
UPDATE (Transact-SQL) UPDATE (Transact-SQL)
MERGE (Transact-SQL) MERGE (Transact-SQL)
Предложение OUTPUT (Transact-SQL) OUTPUT Clause (Transact-SQL)
Использование вставленных и удаленных таблицUse the inserted and deleted Tables