Partilhar via


sys.sp_copy_data_in_batches (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) Azure SQL DatabaseSQL database em Microsoft Fabric

Copia dados da tabela de origem para a tabela de destino depois de verificar se seu esquema é idêntico em termos de número de colunas, nomes de colunas e seus tipos de dados. TRANSACTION IDcolunas , SEQUENCE NUMBERe GENERATED ALWAYS são ignoradas, pois são geradas pelo sistema e isso permite copiar dados de uma tabela regular para uma tabela contábil 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á parcialmente preenchida.

Para obter mais informações sobre o livro-razão do banco de dados, consulte Ledger.

Transact-SQL convenções de sintaxe

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 de 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 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 de código de retorno

0 (sucesso)

Conjunto de resultados

Nenhuma.

Permissões

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