Compartilhar via


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

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

@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.