sys.sp_copy_data_in_batches (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) Banco de Dados SQL do Azure

Copia dados da tabela de origem para a tabela de destino depois de verificar se o esquema é idêntico em termos de número de colunas, nomes de coluna e tipos de dados. As colunas TRANSACTION ID, SEQUENCE NUMBER e GENERATED ALWAYS são ignoradas, pois são geradas pelo sistema e isso permite a cópia de dados de uma tabela regular para uma tabela do razão e vice-versa. Os índices entre as tabelas podem ser diferentes, mas a tabela de destino só pode ser um heap ou ter um índice clusterizado. Os dados são copiados em lotes em transações individuais. Se a operação falhar, a tabela de destino será populada parcialmente.

Para obter mais informações sobre o razão do banco de dados, confira Razão.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_copy_data_in_batches
     [ @source_table_name = ] N'source_table_name'
     , [ @target_table_name = ] N'target_table_name'

Argumentos

@source_table_name [ = ] N'source_table_name'

O nome da tabela a ser usada como a fonte da cópia de dados.

@target_table_name [ = ] N'target_table_name'

O nome da tabela a ser usada como destino da cópia de dados.

Valores do código de retorno

0 (êxito)

Conjunto de resultados

Nenhum.

Permissões

Essa operação requer SELECT na tabela de origem, INSERT na tabela de destino e ALTER na tabela de destino se houver restrições de chave estrangeira ou verificação que serão desabilitadas ou uma coluna de identidade que será ajustada.