Destino ODBC
se aplica a:
SQL Server SSIS Integration Runtime no Azure Data Factory
O destino ODBC carrega dados em massa em tabelas de banco de dados suportadas por ODBC. O destino ODBC usa um gerenciador de conexões ODBC para se conectar à fonte de dados.
Um destino ODBC inclui mapeamentos entre colunas de entrada e colunas na fonte de dados de destino. Não é necessário mapear colunas de entrada para todas as colunas de destino, mas dependendo das propriedades das colunas de destino, podem ocorrer erros se nenhuma coluna de entrada for mapeada para as colunas de destino. Por exemplo, se uma coluna de destino não permitir valores nulos, uma coluna de entrada deverá ser mapeada para essa coluna. Além disso, colunas de diferentes tipos podem ser mapeadas, no entanto, se os dados de entrada não forem compatíveis com o tipo de coluna de destino, ocorrerá um erro no tempo de execução. Dependendo da configuração do comportamento do erro, o erro será ignorado, causará uma falha ou a linha será enviada para a saída de erro.
O destino ODBC tem uma saída regular e uma saída de erro.
Opções de carregamento
O destino ODBC pode usar um dos dois módulos de carga de acesso. Você define o modo no Editor de código-fonte ODBC (página Gerenciador de conexões). Os dois modos são:
Batch: Neste modo, o destino ODBC tenta usar o método de inserção mais eficiente com base nos recursos percebidos do provedor ODBC. Para a maioria dos provedores ODBC modernos, isso significaria preparar uma instrução INSERT com parâmetros e, em seguida, usar uma vinculação de parâmetros de matriz em linha (onde o tamanho da matriz é controlado pela propriedade BatchSize
). Se selecionar o Lote e o provedor não oferecer suporte a este método, o destino ODBC alternará automaticamente para o modo Linha por Linha . linha a linha: Neste modo, o destino ODBC prepara uma instrução INSERT com parâmetros e usa SQL Execute para inserir linhas uma de cada vez.
Tratamento de erros
O destino ODBC tem uma saída de erro. A saída de erro do componente inclui as seguintes colunas de saída:
Código de erro: O número que corresponde ao erro atual. Consulte a documentação do banco de dados de origem para obter uma lista de erros. Para obter uma lista de códigos de erro SSIS, consulte Código de erro SSIS e Referência de mensagem.
Coluna de erro: A coluna de origem que causa o erro (para erros de conversão).
As colunas de dados de saída padrão.
Dependendo da configuração do comportamento de erro, o destino ODBC suporta o retorno de erros (conversão de dados, truncamento) que ocorrem durante o processo de extração na saída de erro. Para obter mais informações, consulte Editor de código-fonte ODBC (página de saída de erro).
Paralelismo
Não há limitação no número de componentes de destino ODBC que podem ser executados em paralelo na mesma tabela ou em tabelas diferentes, na mesma máquina ou em máquinas diferentes (além dos limites normais de sessão global).
No entanto, as limitações do provedor ODBC que está sendo usado podem restringir o número de conexões simultâneas através do provedor. Essas limitações limitam o número de instâncias paralelas suportadas possíveis para o destino ODBC. O desenvolvedor do SSIS deve estar ciente das limitações de qualquer provedor ODBC que está sendo usado e levá-las em consideração ao criar pacotes SSIS.
Você também deve estar ciente de que o carregamento simultâneo na mesma tabela pode reduzir o desempenho devido ao bloqueio de registro padrão. Isso depende dos dados que estão sendo carregados e da organização da tabela.
Resolução de problemas do destino ODBC
Você pode registrar as chamadas que a fonte ODBC faz para provedores de dados externos. Você pode usar esse recurso de log para solucionar problemas de salvamento de dados em fontes de dados externas que o destino ODBC executa. Para registrar as chamadas que o destino ODBC faz para provedores de dados externos, habilite o rastreamento do gerenciador de driver ODBC. Para obter mais informações, consulte a documentação da Microsoft sobre como gerar um traço ODBC com o Administrador de Fonte de Dados.
Configurando o destino ODBC
Você pode configurar o destino ODBC programaticamente ou por meio do Designer SSIS
Para obter mais informações, consulte um dos seguintes tópicos:
A caixa de diálogo Advanced Editor contém as propriedades que podem ser definidas programaticamente.
Para abrir a caixa de diálogo Advanced Editor:
- Na tela de Fluxo de Dados do seu projeto do SQL Server 2019 Integration Services (SSIS), clique com o botão direito do mouse no destino ODBC e selecione Mostrar Editor Avançado.
Para obter mais informações sobre as propriedades que você pode definir na caixa de diálogo Editor Avançado, consulte Propriedades personalizadas de destino ODBC.
Nesta secção
Editor de destino ODBC (página Gerenciador de conexões)
Utilize a página Connection Manager da caixa de diálogo Editor de Destino ODBC para selecionar o gestor de ligações ODBC para o destino. Esta página também permite selecionar uma tabela ou exibição do banco de dados
Para abrir a página do Gerenciador de conexões do Editor de destino ODBC
Lista de tarefas
No SQL Server Data Tools, abra o pacote do SQL Server 2019 Integration Services (SSIS) que tem o destino ODBC.
No separador Fluxo de Dados, clique duas vezes no destino ODBC.
No Editor de Destino ODBC, clique em Gerenciador de Conexões.
Opções
Gestor de ligações
Selecione um gerenciador de conexões ODBC existente na lista ou clique em Novo para criar uma nova conexão. A conexão pode ser com qualquer banco de dados suportado por ODBC.
Novo
Clique Novo. A caixa de diálogo Configurar o Editor do Gerenciador de Conexões ODBC é aberta, onde você pode criar um novo gerenciador de conexões.
Modo de Acesso a Dados
Selecione o método para carregar dados no destino. As opções são mostradas na tabela a seguir:
| Opção | Descrição |
|---|---|
| Nome da tabela - Lote | Selecione esta opção para configurar o destino ODBC para funcionar no modo de lote. Quando você seleciona essa opção, as seguintes opções estão disponíveis: |
|
Nome da tabela ou da vista: Selecione uma tabela ou vista disponível na lista. Esta lista contém apenas as primeiras 1000 tabelas. Se o banco de dados contiver mais de 1000 tabelas, você poderá digitar o início de um nome de tabela ou usar o curinga (*) para inserir qualquer parte do nome para exibir a tabela ou tabelas que deseja usar. Tamanho do lote: Digite o tamanho do lote para carregamento em massa. Este é o número de linhas carregadas em lote |
|
| Nome da tabela - linha por linha | Selecione esta opção para configurar o destino ODBC para inserir cada uma das linhas na tabela de destino, uma de cada vez. Quando você seleciona essa opção, a seguinte opção está disponível: |
|
Nome da tabela ou do modo de exibição: Selecione uma tabela ou exibição disponível no banco de dados da lista. Esta lista contém apenas as primeiras 1000 tabelas. Se o banco de dados contiver mais de 1000 tabelas, você poderá digitar o início de um nome de tabela ou usar o curinga (*) para inserir qualquer parte do nome para exibir a tabela ou tabelas que deseja usar. |
Pré-visualização
Clique em Pré-visualização para visualizar até 200 linhas de dados da tabela que selecionou.
Editor de destino ODBC (página Mapeamentos)
Use a página Mapeamentos de
Opções
Colunas de entrada disponíveis
A lista de colunas de entrada disponíveis. Arraste e solte uma coluna de entrada em uma coluna de destino disponível para mapear as colunas.
Colunas de destino disponíveis
A lista de colunas de destino disponíveis. Arraste e solte uma coluna de destino em uma coluna de entrada disponível para mapear as colunas.
Coluna de entrada
Exiba as colunas de entrada selecionadas. Você pode remover mapeamentos selecionando <ignorar> excluir colunas da saída.
Coluna de destino
Veja todas as colunas de destino disponíveis, mapeadas e não mapeadas.
Editor de destino ODBC (página de saída de erro)
Use a página de saída de erro
Para abrir a página de saída de erro do Editor de destino ODBC
Lista de tarefas
No SQL Server Data Tools, abra o pacote do SQL Server 2019 Integration Services (SSIS) que tem o destino ODBC.
Na guia Fluxo de Dados, clique duas vezes no destino ODBC.
No Editor de Destino do ODBC, clique em Saída de Erro.
Opções
Entrada/Saída
Exiba o nome da fonte de dados.
Coluna
Não utilizado.
Erro
Selecione como o destino ODBC deve lidar com erros em um fluxo: ignore a falha, redirecione a linha ou falhe o componente.
Truncamento
Selecione como o destino ODBC deve lidar com o truncamento em um fluxo: ignore a falha, redirecione a linha ou falhe o componente.
Descrição
Veja uma descrição do erro.
Definir este valor para células selecionadas
Selecione como o destino ODBC lida com todas as células selecionadas quando ocorre um erro ou truncamento: ignore a falha, redirecione a linha ou falhe o componente.
Candidatar-se
Aplique as opções de tratamento de erros às células selecionadas.
Opções de tratamento de erros
Use as opções a seguir para configurar como o destino ODBC manipula erros e truncamentos.
Componente de falha
A tarefa Fluxo de Dados falha quando ocorre um erro ou um truncamento. Este é o comportamento padrão.
Ignorar erro
O erro ou o truncamento é ignorado.
Fluxo de redirecionamento
A linha que está causando o erro ou o truncamento é direcionada para a saída de erro do destino do ODBC. Para obter mais informações, consulte Destino ODBC.