Destino do Teradata
Aplica-se a: 
SQL Server SSIS Integration Runtime no Azure Data Factory
O destino do Teradata carrega dados em massa no Banco de Dados do Teradata.
O destino usa o gerenciador de conexões do Teradata para se conectar à fonte de dados. Confira mais informações em Gerenciador de conexão do Teradata.
Opções de carregamento
O destino do Teradata dá suporte a dois modos de carregamento de dados:
Fluxo de TPT: Esse modo usa o operador de Fluxo de API TPT (protocolo Teradata TPump).
Carregamento TPT (carregamento em massa rápido): Esse modo usa o operador de Carregamento de API TPT (protocolo Teradata FastLoad) para carregamento em massa rápido.
O modo de carregamento rápido tem as seguintes restrições:
O limite de sessões para o banco de dados do Teradata é determinado por qualquer fator abaixo que for encontrado primeiro:
- Limites de sessão definidos usando o comando SESSIONS
- O limite de uma sessão por AMP para o Banco de Dados do Teradata
- O limite da plataforma para o número máximo de sessões por aplicativo: definido pela variável MaxSess no arquivo de software de interface do COP (Processador de Comunicações), CLISPB. DAT. Você pode usar o comando TDP SET MAXSESSIONS para especificar o limite de plataforma. O limite padrão é igual a MAXSESS do servidor.
Não há suporte para a união de índices.
Não há suporte para referências de chave estrangeira em tabelas de destino.
Não há suporte para tabelas de destino definidas com um índice secundário.
Para saber mais sobre as restrições de carregamento rápido do Teradata, confira a referência do carregamento rápido do Teradata.
É possível definir o modo no Editor de Destino do Oracle (Página do Gerenciador de Conexões).
Tratamento de erros
Os erros retornados durante o processo de carregamento são gravados em tabelas de erro temporárias que ficam bloqueadas durante o processo de carregamento. A propriedade Número máximo de erros (MaxErrors) do Editor Avançado define o número máximo de erros que pode ocorrer.
Se o número máximo de erros for maior que zero, serão geradas tabelas de erros com nomes exclusivos, e a mensagem informativa será impressa no log do pacote. Os erros podem ser recuperados por saída de erro do componente SSIS padrão.
As tabelas temporárias são removidas quando o processo de carregamento é concluído. Se as tabelas temporais não puderem ser lidas pelo destino do Teradata, não serão removidas, a menos que a propriedade Sempre remover tabela de erros esteja marcada. Se o processo de carregamento for interrompido antes da conclusão, você precisará remover manualmente essas tabelas, se necessário. Essas tabelas ficam no mesmo banco de dados com a tabela de destino.
Quando o Número máximo de erros é atingido, o estado da tabela de destino depende do modo em uso.
- No modo de carregamento rápido, a tabela de destino não pode ser usada. Para executar novamente, você deve truncar ou remover e recriar a tabela de destino. Não há suporte para reversão.
- No modo de operador do Fluxo de TPT, o destino do Teradata é executado por meio do mecanismo de linha em buffer. Se o trabalho falhar, todas as alterações concluídas (buffers que foram enviados) no momento da falha serão permanentes nas tabelas de destino. Não há nenhum conceito de reversão. As tabelas de erros serão removidas.
O destino do Teradata tem uma saída de erro. Confira mais informações em Editor de Destino do Teradata (Página Saída de Erro).
Paralelismo
O paralelismo é restrito no modo de carregamento rápido, vários trabalhos independentes de carregamento rápido não podem acessar a mesma tabela ao mesmo tempo. Além disso, o número de trabalhos simultâneos de carregamento rápido é limitado pela variável MaxLoadTasks do banco de dados.
Não há nenhuma restrição de paralelismo no modo de Fluxo de TPT. É possível executar simultaneamente vários destinos do Teradata na mesma tabela, embora isso possa reduzir o desempenho por Teradata. Confira a documentação do Teradata para obter mais informações.
Solução de problemas de destino do Teradata
Você pode registrar as chamadas que a origem do Teradata faz para a API TPT (Teradata Parallel Transporter). Você pode habilitar o registro em log do pacote e selecione o evento Diagnóstico no nível do pacote para registrar as chamadas.
Você pode registrar as chamadas ODBC que a origem do Teradada faz para o driver ODBC do Teradata ao habilitar o rastreamento do gerenciador do 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.
Propriedades personalizadas de destino do Teradata
A tabela a seguir descreve as propriedades personalizadas do destino do Teradata. Todas as propriedades são de leitura/gravação.
| Nome da propriedade | Tipo de Dados | Descrição |
|---|---|---|
| AlwaysDropErrorTable | Booliano | O padrão é False. Remova todas as tabelas de erro se for True, mesmo que o destino do Teradata falhe na leitura. |
| ArraySupport | Booliano | O padrão é True. Os grupos DML usam ArraySupport se for True. Aplicável somente ao Fluxo de TPT. Essa propriedade está no Editor Avançado. |
| Buffers | Integer | O número de buffers de solicitação a aumentar, o valor pode ser definido de 2 a 64. Aplicável somente ao Fluxo de TPT. Essa propriedade está no Editor Avançado. |
| BufferMode | Booliano | O padrão é True. Deve ser True se o recurso PutBuffer for usado. Essa propriedade está no Editor Avançado. |
| BufferSize | Integer | O tamanho do buffer de saída (em KB) usado para enviar os totais de carregamento. O valor padrão é 1.024. Aplicável somente para o Carregamento do TPT. Essa propriedade está no Editor Avançado. |
| DataEncryption | Booliano | O padrão é False. A criptografia de segurança completa será usada se for True. |
| DefaultCodePage | Integer | A página de código a ser usada quando a fonte de dados não tiver informações da página de código. Observação: Essa propriedade está no Editor Avançado. |
| DetailedTracingLevel | Inteiro (Enumeração) | Selecione uma das seguintes opções para o rastreamento avançado: Off: sem registro em log avançado. Geral: o rastreamento geral de atividades específicas do driver é registrado. CLI: o rastreamento de atividades relacionadas ao CLIv2 é registrado. Notificar Método: o rastreamento de atividades relacionadas ao recurso de notificação é registrado. Biblioteca Comum: o rastreamento de atividades da biblioteca opcommon é registrado. Tudo: o rastreamento de todas as atividades acima é registrado. O arquivo de log de rastreamento avançado é definido na propriedade DetailedTracingFile. A propriedade DetailedTracingFile deve ser definida se a opção não estiver desativada. Essa propriedade está no Editor Avançado. |
| DetailedTracingFile | String | O caminho do arquivo de log gerado automaticamente quando DetailedTracingLevel não está desativado. Essa propriedade está no Editor Avançado. |
| DiscardLargeRow | Booliano | O padrão é False. Remover linhas grandes (maiores que 64K) se for True |
| ErrorTableName | String | Nome da tabela de erros. O padrão é o nome da tabela de destino |
| ExtendedStringColumnsAllocation | Booliano | Fator de Alocação Máxima de Caracteres de Transferência será usado se for True. Esse valor deve ser definido como True se a propriedade Exportar ID da Tabela de Largura do banco de dados do Teradata estiver definida como Padrões Máximos. O padrão é False. |
| FastLoad | Booliano | O carregamento rápido é usado se for True. O valor padrão é false. Também pode ser definido no Editor de Destino do Teradata (Página do Gerenciador de Conexões). |
| MaxErrors | Integer | O número de erros que pode ocorrer antes que o fluxo de dados cesse. O valor padrão é 0, o que significa que não há limite para o número de erros. Se o Fluxo de redirecionamento for selecionado na página de Tratamento de erros. Antes que o limite de número de erros seja atingido, todos os erros retornam na saída de erro. Confira mais informações em Editor de Destino do Teradata (Página Saída de Erro). |
| MaxSessions | Integer | O número máximo de sessões que estão conectadas. Esse valor deve ser maior que um. O valor padrão é uma sessão para cada AMP disponível. |
| MinSessions | Integer | O número mínimo de sessões que estão conectadas. Esse valor deve ser maior que um. O valor padrão é uma sessão para cada AMP disponível. |
| Pack | Integer | O número de instruções a serem empacotadas em uma solicitação com várias instruções. O padrão é 20, o máximo permitido é 2400. Aplicável somente ao Fluxo de TPT. Essa propriedade está no Editor Avançado. |
| PackMaximum | Booliano | Determina dinamicamente o fator máximo do pacote para o trabalho de fluxo atual se for True. Aplicável somente ao Fluxo de TPT. Essa propriedade está no Editor Avançado. |
| QueryBandSessInfo | Varchar | Uma expressão de banda de consulta definida pelo usuário e com base em sessão para habilitar o monitoramento e a governança de estornos. Essa propriedade deve estar no formato de cadeia de conexão. Essa propriedade está no Editor Avançado. |
| ReplicationOveride | Inteiro (enumeração) | Opções: Padrão: a instrução No SET SESSION OVERRIDE REPLICATION é enviada ao banco de dados. As configurações padrão do banco de dados são usadas. Em: os controles de serviço de replicação normais são substituídos. Off: os controles de serviço de replicação normais são usados. Essa propriedade é aplicável somente ao Fluxo de TPT. Essa propriedade está no Editor Avançado. |
| Robust | Booliano | A lógica de reinicialização robusta é usada em operações de recuperação e reinicialização se for True. Essa propriedade é aplicável somente ao Fluxo de TPT. Essa propriedade está no Editor Avançado. |
| TableName | String | O nome da tabela com os dados que estão sendo usados. |
| TenacityHours | Integer | O número de horas que o driver TPT tenta fazer logon quando o número máximo de operações de carregamento/exportação ainda estiver em execução. O padrão é de 4 horas. Essa propriedade está no Editor Avançado |
| TenacitySleep | Integer | Os minutos que o driver TPT pausa antes de tentar fazer logon quando o limite é atingido. O limite é definido pelas propriedades MaxSessions e TenacityHours. O padrão é seis minutos. Essa propriedade está no Editor Avançado |
| UnicodePassThrough | Booliano | Off (padrão): desabilita a Passagem Unicode. On: habilita a Passagem Unicode. |
Configurar o destino do Teradata
O destino do Teradata pode ser configurado programaticamente ou por meio do Designer SSIS.
O Editor de Destino do Teradata é mostrado na figura abaixo. Ele contém a Página do Gerenciador de Conexões, a Página de Mapeamentos e a Página de Saída de Erro.
Para obter mais informações, consulte um dos tópicos a seguir.
- Editor de Destino do Teradata (Página do Gerenciador de Conexões)
- Editor de Destino do Teradata (Página de Mapeamentos)
- Editor de Destino do Teradata (Página de Saída de Erro)
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 Integration Services, clique com o botão direito do mouse no destino do Teradata e selecione Mostrar Editor Avançado.
Para saber mais sobre as propriedades que podem ser definidas na caixa de diálogo Editor Avançado, confira as Propriedades personalizadas do destino do Teradata.
Editor de Destino do Teradata (Página do Gerenciador de Conexões)
Use a página do Gerenciador de Conexões da caixa de diálogo Editor de Destino do Teradata para selecionar o gerenciador de conexões do Teradata 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 do Teradata
No SQL Server Data Tools, abra o pacote do SSIS (SQL Server Integration Services) que contém o destino do Teradata.
Na guia Fluxo de Dados, clique duas vezes no destino do Teradata.
No Editor de Destino do Teradata, clique em Gerenciador de Conexões.
Opções
Connection manager
Selecione um gerenciador de conexões existente na lista ou clique em Novo para criar um novo gerenciador de conexões do Teradata.
Novo
Clique em Nova. A caixa de diálogo Editor do Gerenciador de Conexões do Teradata é aberta, e nela você pode criar um novo gerenciador de conexões.
Modo de acesso aos dados
Especifique o método para selecionar dados da origem. As opções são mostradas na tabela a seguir:
| Opção | Descrição |
|---|---|
| Nome da Tabela – Fluxo de TPT | Modo incremental usando o operador de Fluxo de TPT. Nome da tabela ou da exibição: selecione uma tabela ou exibição existente na lista. Esta lista mostra apenas as primeiras 1.000 tabelas. Você pode digitar o prefixo do nome da tabela ou usar qualquer parte do nome com o curinga (*) para listar a tabela ou as tabelas que deseja usar. |
| Nome da Tabela – Carregamento de TPL | Modo de carregamento rápido (Caminho Direto) usando o operador de carregamento da API TPT (protocolo Teradata FastLoad), que requer que a tabela de destino esteja vazia. Nome da tabela ou da exibição: selecione uma tabela ou exibição existente na lista. Esta lista mostra apenas as primeiras 1.000 tabelas. Você pode digitar o prefixo do nome da tabela ou usar qualquer parte do nome com o curinga (*) para listar a tabela ou as tabelas que deseja usar. |
Criptografia de dados Marque a caixa de seleção para habilitar a criptografia de dados. O padrão não está selecionado.
Sempre remover tabela de erros Marque a caixa de seleção para remover tabelas de erros em todas as instâncias.
Tabela de erros Nome da tabela na qual os erros são gravados.
Número mínimo de sessões O número mínimo de sessões que estão conectadas. O valor padrão é uma sessão para cada AMP disponível. O valor deve ser maior que um.
Número máximo de sessões O número máximo de sessões que estão conectadas. O valor padrão é uma sessão para cada AMP disponível. O valor deve ser maior que um.
Número máximo de erros O número máximo de erros que podem ser retornados antes que o fluxo de dados seja interrompido ou redirecionado.
Editor de Destino do Teradata (Página de Mapeamentos)
Use a página Mapeamentos da caixa de diálogo Editor de Destino do Teradata para mapear as colunas de entrada para as colunas de destino.
Para abrir a Página de Mapeamentos do Editor de Destino do Teradata
No SQL Server Data Tools, abra o pacote do SSIS (SQL Server Integration Services) que contém o destino do Teradata.
Na guia Fluxo de Dados, clique duas vezes no destino do Teradata.
No Editor de Destino do Teradata, clique em Mapeamentos.
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.
Observação
As colunas de tipos de dados sem suporte serão excluídas do mapeamento, e um aviso é emitido.
Editor de Destino do Teradata (Página de Saída de Erro)
Use a página de Saída de Erro da caixa de diálogo Editor de Destino do Teradata para selecionar as opções para tratamento de erros.
Para abrir a Página de Saída de Erro do Editor de Destino do Teradata
No SQL Server Data Tools, abra o pacote do SSIS (SQL Server Integration Services) que contém o destino do Teradata.
Na guia Fluxo de Dados, clique duas vezes no destino do Teradata.
No Editor de Destino do Teradata, clique em Saída de Erro.
Opções
Comportamento do erro
Selecione como o destino do Teradata deve tratar erros em um fluxo: ignorar a falha, redirecionar a linha ou causar falha no componente.
Tópicos relacionados: Tratamento de Erro em Dados
Truncation
Selecione como o destino do Teradata deve tratar truncamento em um fluxo: ignorar a falha, redirecionar a linha ou causar falha no componente.
Próximas etapas
- Configurar o gerenciador de conexões do Teradata
- Configurar a origem do Teradata
- Configurar o destino do Teradata
- Em caso de dúvidas, acesse a Tech Community.