Destino ODBC

  • Artigo

Aplica-se a:SQL Server SSIS Integration Runtime no Azure Data Factory

O destino ODBC carrega dados em massa em tabelas de bancos de dados com suporte ODBC. O destino ODBC usa um gerenciador de conexões ODBC para se conectar à fonte de dados.

Um destino ODBC inclui mapeamentos entre as colunas de entrada e as colunas da fonte de dados de destino. Você não precisa mapear as colunas de entrada para todas as colunas de destino, mas, dependendo das propriedades das colunas de destino, poderão ocorrer erros se nenhuma das colunas 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 deve ser mapeada para aquela coluna de destino. Além disso, colunas de tipos diferentes podem ser mapeadas, porém se os dados de entrada não forem compatíveis com o tipo de coluna de destino, um erro ocorrerá em runtime. Dependendo da configuração de comportamento do erro, o erro será ignorado, causará uma falha ou a linha será enviada à 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 de dois módulos de carga de acesso. Defina o modo no Editor de Fonte ODBC (Página Gerenciador de Conexões). Os dois modos são:

  • Lote: nesse modo, o destino ODBC tenta usar o método de inserção mais eficiente com base nos recursos do provedor ODBC percebido. Para a maioria dos provedores ODBC modernos, isso significa preparar uma instrução INSERT com parâmetros e usar uma associação de parâmetro de matriz row-wise (em que o tamanho da matriz é controlado pela propriedade BatchSize ). Se você selecionar Lote e o provedor não oferecer suporte a esse método, o destino ODBC alternará automaticamente para modo Linha a linha .

  • Linha a Linha: nesse 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 de componente inclui as colunas de saída seguintes:

  • Código de Erro: o número que corresponde ao erro atual. Consulte a documentação do seu banco de dados de origem para obter uma lista de erros. Para obter uma lista dos códigos de erro SSIS, consulte a Referência de código e mensagem de erro SSIS.

  • 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 de comportamento de erro, o destino ODBC oferece suporte ao retorno de erros (conversão de dados, truncamento) que ocorre durante o processo de extração na saída de erro. Para obter mais informações, confira Editor de origem ODBC (Página Saída de Erro).

Paralelismo

Não há nenhuma limitação no número de componentes de destino ODBC que podem ser executados em paralelo na mesma tabela ou tabelas diferentes, na mesma máquina ou em máquinas diferentes (diferente de limites de sessão globais normais).

No entanto, as imitações do provedor ODBC sendo usado podem restringir o número de conexões simultâneas pelo provedor. Essas limitações restringem o número de instâncias paralelas com suporte possível para o destino ODBC. O desenvolvedor SSIS deve estar consciente das limitações de qualquer provedor ODBC usado e considerá-las ao compilar pacotes SSIS.

Você também deve estar ciente de que i carregamento simultâneo na mesma tabela pode reduzir o desempenho devido ao bloqueio de registro padrão. Isso depende dos dados sendo carregados e da organização da tabela.

Solucionando problemas do destino ODBC

Você pode registrar as chamadas que a origem ODBC faz para provedores de dados externos. É possível usar essa capacidade de registro para solucionar o problema de salvar os dados em fontes de dados externas que o destino ODBC executa. Para registrar em log as chamadas que o destino ODBC faz a provedores de dados externos, habilite o rastreamento do gerenciador de driver ODBC. Para obter mais informações, consulte a documentação da Microsoft em Como gerar um rastreamento ODBC com o administrador de fonte de dados.

Configurando o destino ODBC

Você pode configurar o destino ODBC programaticamente ou por meio do SSIS Designer

Para obter mais informações, consulte um dos tópicos a seguir.

A caixa de diálogo Editor Avançado contém as propriedades que podem ser definidas programaticamente.

Para abrir a caixa de diálogo Editor Avançado :

  • Na tela Fluxo de Dados do projeto do SSIS (SQL Server 2019 Integration Services), 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 podem ser definidas na caixa de diálogo Editor Avançado, consulte Propriedades personalizadas de destino ODBC.

Nesta seção

Editor do Destino ODBC (página Gerenciador de Conexões)

Use a página Gerenciador de Conexões da caixa de diálogo Editor de Destino ODBC para selecionar o gerenciador de conexões para o destino. Essa página também permite que você selecione uma tabela ou exibição a partir 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 SSIS (SQL Server 2019 Integration Services) que tem o destino ODBC.

  • Na guia Fluxo de Dados , clique duas vezes no destino ODBC.

  • No Editor de Destino ODBC, clique em Gerenciador de Conexões.

Opções

Gerenciador de conexões

Selecione na lista um gerenciador de conexões ODBC existente ou clique em Novo para criar uma nova conexão. A conexão pode ser com qualquer banco de dados com suporte ODBC.

Novo

Clique em Nova. É aberta a caixa de diálogo Configurar Editor do Gerenciador de Conexões ODBC , na qual você pode criar um novo gerenciador de conexões.

Modo de acesso a dados

Selecione o método de carregamento de 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 trabalhar no modo de lote. Ao selecionar esta opção, as seguintes opções estão disponíveis:
Nome da tabela ou exibição: selecione uma tabela ou exibição disponível na lista.

Essa lista contém apenas as primeiras 1.000 tabelas. Se o banco de dados contiver mais de 1.000 tabelas, você poderá digitar o início do nome de uma tabela ou usar o curinga (*) para inserir qualquer parte do nome para exibir a tabela ou tabelas desejadas.

Tamanho do lote: digite o tamanho do lote para carregamento em massa. Esse é o número de linhas carregadas como um lote
Nome da Tabela - Linha a Linha Selecione esta opção para configurar o destino ODBC para inserir cada uma das linhas na tabela de destino, uma de cada vez. Ao selecionar esta opção, a seguinte opção está disponível:
Nome da tabela ou exibição: selecione uma tabela ou exibição disponível no banco de dados na lista.

Essa lista contém apenas as primeiras 1.000 tabelas. Se o banco de dados contiver mais de 1.000 tabelas, você poderá digitar o início do nome de uma tabela ou usar o curinga (*) para inserir qualquer parte do nome para exibir a tabela ou tabelas desejadas.

Visualização

Clique em Visualizar para exibir até 200 linhas de dados da tabela selecionada.

Editor de Destino ODBC (página Mapeamentos)

Use a página Mapeamentos da caixa de diálogo ODBC Destination Editor (Editor de Destino ODBC) para mapear colunas de entrada para colunas de destino.

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 que você selecionou. Você pode remover os mapeamentos selecionando <ignorar> para excluir as colunas da saída.

Coluna de Destino

Exiba todas as colunas de destino disponíveis, mapeadas e não mapeadas.

Editor de Destinos ADO NET (página Saída de Erro)

Use a página Saída de Erro da caixa de diálogo Editor de Destino ODBC para selecionar as opções para tratamento de erros.

Para abrir a página Saída de Erro do Editor de Destino ODBC

Lista de Tarefas

  • No SQL Server Data Tools, abra o pacote SSIS (SQL Server 2019 Integration Services) que tem o destino ODBC.

  • Na guia Fluxo de Dados , clique duas vezes no destino ODBC.

  • No Editor de Destino ODBC, clique em Saída de Erro.

Opções

Entrada/Saída

Exibe o nome da fonte de dados.

Coluna

Não usado.

Erro

Selecione como o destino ODBC deve tratar erros em um fluxo: ignorar a falha, redirecionar a linha ou causar falha no componente.

Truncation

Selecione como o destino ODBC deve tratar truncamento em um fluxo: ignorar a falha, redirecionar a linha ou causar falha no componente.

DESCRIÇÃO

Exiba uma descrição do erro.

Definir este valor para células selecionadas

Selecione como o destino ODBC trata todas as células selecionadas quando ocorre um erro ou um truncamento: ignorar a falha, redirecionar a linha ou causar a falha no componente.

Aplicar

Aplique as opções de tratamento de erros às células selecionadas.

Opções de tratamento de erros

Você usa as opções a seguir para configurar como o destino ODBC trata erros e truncamentos.

Falha no Componente

A tarefa Fluxo de Dados falha quando ocorre um erro ou um truncamento. Esse é o comportamento padrão.

Ignorar Falha

O erro ou o truncamento é ignorado.

Redirecionar fluxo

A linha que está causando o erro ou o truncamento é direcionada para a saída do erro do destino ODBC. Para obter mais informações, consulte Destino ODBC.