Conexão ODBC (DataStage)

Use a conexão ODBC para se conectar a um banco de dados com a interface de programação de aplicativos (API) ODBC. A conexão ODBC é otimizada para o conector ODBC do DataStage e pode ser utilizada apenas em fluxos do DataStage.

O conector e conexão ODBC fornecem estes benefícios:

  • Visualizar mensagens de erro geradas na execução da tarefa.
  • Especificar controle de baixa granularidade nas propriedades de uso do conector.
  • Propriedades adicionais de conexão ou driver ODBC para implementações customizadas, tais como autenticação de banco de dados LDAP ou suporte a grandes bancos de dados.

É possível incluir essa conexão em um espaço de implementação Clique em Importar ativos> Acesso a dados> Conexão.. Consulte Incluindo ativos de dados em um espaço de implementação

Restrição

A conexão ODBC pode usar somente os drivers ODBC fornecidos pela IBM.

Fontes de dados compatíveis com o SSL

Para uma conexão habilitada para o Protocolo de Autenticação de Servidor ( SSL ), você pode especificar o certificado usando o TS=data: atributo no campo Propriedades adicionais.
Exemplo EncryptionMethod=1;AuthenticationMethod=0;ValidateServerCertificate=1;TS=data://-----BEGIN CERTIFICATE-----xxxx -----END CERTIFICATE-----

Consulte a documentação de Progresso para a origem de dados para quaisquer atualizações na sintaxe.

Criando uma conexão ODBC com uma origem de dados

  1. Na página do projeto, clique na guia Ativos
  2. Clique em Novo ativo> Conectar a uma origem de dados.
  3. Selecione ODBC e, em seguida, selecione um tipo de origem de dados.
  4. Insira os detalhes para a conexão.

Veja a seguir as fontes de dados compatíveis com uma conexão ODBC para a arquitetura x86_64 :

Veja a seguir as fontes de dados compatíveis com uma conexão ODBC para a arquitetura s390x :

Veja a seguir as fontes de dados compatíveis com a conexão ODBC para a arquitetura ppc64le :

A conexão ODBC é compatível com o conector IBM Cloud Satellite. O bloco IBM Cloud Satellite está disponível na seção Private Connectivity (Conectividade privada ) do formulário Create connection (Criar conexão ). Você pode configurar um conector Satellite para se conectar com segurança à sua fonte de dados a partir de um contêiner Docker em sua infraestrutura local ou configurar um local Satellite com vários hosts em sua infraestrutura, como um data center local ou na nuvem.

Em ambientes de nuvem com Satellite Connectivity, trabalhos de longa duração podem acionar erros de tempo limite, especialmente com conectores ODBC como fontes de dados. Esses erros geralmente ocorrem durante a fase de desconexão iniciada pelo nó Conductor.

Para resolver isso, defina o parâmetro de trabalho ISKeepConductorConnection=0. Essa configuração desconecta a conexão do Conductor após o processamento do pré-trabalho e antes da execução do trabalho principal. Se houver uma instrução afterSQL, a conexão será restabelecida automaticamente durante o processamento pós-trabalho.

Essa abordagem evita problemas de tempo limite do Satellite, eliminando estados de conexão prolongados que excedem os limites de tempo limite durante tempos de execução prolongados do trabalho. Para obter mais informações, consulte Configuração de um conector Satellite.

Apache Cassandra

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMcsndr00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.00.0340 (B1181, U0931)

  • Nome do Host
  • Número da porta
  • Nós do cluster: uma lista separada por vírgula de nomes de membros no cluster. Formato de uso HostName:Port,HostName:Port.
  • Keyspace: o keyspace ao qual você deseja se conectar. O valor do keyspace também é usado como qualificador padrão para nomes de tabelas não qualificados em consultas.
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor Apache Cassandra. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para Apache Cassandra.

Restrições para o Apache Cassandra

  • Os modos de Criação e Gravação de Substituição não são suportados.
  • O banco de dados não aplica restrição de chave primária nos modos Inserir novas linhas somente e Inserir e, em seguida, atualizar. Em vez disso, ele atualiza essa linha (mesmo através do shell CQLSH).

 

Apache Hive

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMhive00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.01.1035 (B2055, U1864)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor Apache Hive. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para Apache Hive.

Restrições para o SQL gerado para o Apache Hive

  • Se a SQL gerada não funcionar, deve-se fornecer sua própria instrução SQL
  • A propriedade Ativar identificadores entre aspas não é suportada para a origem de dados Apache Hive .
  • Para visualizar os dados, use letras minúsculas para o valor no campo Nome da tabela nas propriedades do estágio de destino.

 

Google BigQuery

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMgbq00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.00.0357 (B1909, U1715)

  • Projeto: o nome do projeto ao qual conectar. Os projetos no Google BigQuery são equivalentes aos catálogos no ODBC Consulte Projeto na documentação do Progress.
  • Conjunto de dados: o nome do conjunto de dados ao qual conectar. Os conjuntos de dados no Google BigQuery são equivalentes a esquemas no ODBC Consulte Conjunto de dados na documentação do Progress.
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades que sejam necessárias pela instância do Google BigQuery . Para conhecer as propriedades disponíveis, consulte as descrições das opções de conexãoGoogle BigQuery na documentação do Progress.

Método de autenticação

Selecione OAuth2.0 ou Conta de serviço

OAuth 2.0 :

  • ID do cliente: a chave do consumidor para seu aplicativo
  • Segredo do cliente: o segredo do consumidor para o seu aplicativo.
  • Token de atualização: o token de atualização usado para solicitar um novo token de acesso ou renovar um token de acesso expirado.
  • Token de acesso: o token de acesso para autenticar na instância do Google BigQuery .

Conta do Serviço:

  • E-mail da conta de serviço: o endereço de e-mail associado à sua conta de serviço.
  • Método de entrada para chave de conta do serviço: Conteúdo da chave é selecionado por padrão.
  • Conteúdo da chave da conta de serviço: a chave privada que você usa para autenticar para a instância do Google BigQuery

 

Greenplum

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMgplm00.so
Software de progresso DataDirect ODBC versão do arquivo: 07.16.1136 (B0805, U0647)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor Greenplum. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Greenplum Connection.

Visualizando dados de destino no Greenplum
Se seu fluxo do DataStage usar o conector ODBC como um destino e você desejar visualizar os dados, no estágio de destino, selecione Ativar identificadores cotados nas propriedades do estágio.

 

IBM Db2

A fonte de dados Db2 pode ser usada para vários tipos de origem de dados Db2 . Por exemplo, Db2 no AIX, Db2 no Linux, Db2 no Windows ou Db2 Warehouse.

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMdb200.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.0627 (B2069, U1878)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor de banco de dados DB2. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para DB2.

Visualização prévia dos dados de destino no IBM Db2
Se o seu fluxo do DataStage usar o conector ODBC como destino e você quiser visualizar os dados, na etapa de destino, selecione “Ativar identificadores entre aspas ” nas propriedades da etapa.

Db2 Warehouse com autenticação do tipo “ SSL ”
Para se conectar a um banco de dados que utilize uma porta do tipo “ SSL ”, é necessário inserir os atributos “ EncryptionMethod ” (EM) e “ ValidateServerCertificate ” (VSC) da seguinte forma no campo “Propriedades adicionais” da conexão:

EM=1;AM=1;VSC=0

 

IBM Db2 on iSeries (AS400)

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMdb200.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.0627 (B2069, U1878)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor de banco de dados DB2. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para DB2.

Visualização prévia dos dados de destino no IBM Db2 em iSeries ( AS400 )
Se o seu fluxo do DataStage usar o conector ODBC como destino e você quiser visualizar os dados, na etapa de destino, selecione “Ativar identificadores entre aspas ” nas propriedades da etapa.

 

IBM DB2 on Linux on System z

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMdb200.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.0627 (B2069, U1878)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor de banco de dados DB2. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para DB2.

 

IBM Informix

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMifcl00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.0124 (b9990, U1362)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor de banco de dados Informix. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para Informix.

Restrição para IBM Informix
Os caracteres Unicode não são suportados para a origem de dados ODBC Informix .

 

IBM Netezza

Software de progresso DataDirect ODBC versão da biblioteca: libnzodbc.so

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha

Visualizando dados de destino no IBM Netezza
Se o seu fluxo do DataStage usar o conector ODBC como um destino e você desejar visualizar os dados, no estágio de destino, selecione Ativar identificadores cotados sob as propriedades do estágio.

 

Impala

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMimpala00.so
Software de progresso DataDirect ODBC versão do arquivo: 07.16.0515 (B0805, U0647)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor de banco de dados Impala. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para Impala.

 

Microsoft SQL Server

A origem de dados do Microsoft SQL Server pode ser usada para diversos tipos de origem de dados Por exemplo, o Microsoft SQL Server independente, o Microsoft Azure SQL Database ou o Azure Synapse SQL.

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMsqls00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.1500 (B2058, U1867)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias pelo Microsoft SQL Server. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para Microsoft SQL Server.

Inclua o nome de domínio do Windows e o método de autenticação no campo Propriedades Adicionais

Por exemplo: Domain=myco;AM=9;

 

MongoDB

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMmongo00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.10.0248 (B2064, U1873)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor MongoDB. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para MongoDB.

MongoDB com autenticação do tipo “ SSL ”
Para se conectar a um banco de dados que utilize uma porta do tipo “ SSL ”, é necessário inserir os atributos “ EncryptionMethod ” (EM) e “ ValidateServerCertificate ” (VSC) da seguinte forma no campo “Propriedades adicionais” da conexão:

EM=1;AM=1;VSC=0

Restrições para o MongoDB

  • Para usar a origem de dados MongoDB como um destino, deve-se inserir ReadOnly=0 na conexão Propriedades adicionais.
  • Tipos de dados complexos não são suportados
  • Para coleções aninhadas, deve-se comprimir o esquema ou normalizar o esquema e utilizar consultas adequadas. Consulte as informações sobre o atributoSchemaFormat.
  • Os modos de Gravação Criar e Substituir não são suportados
  • Inserir com violação de chave primária, Inserir novas linhas apenas e Inserir e, em seguida, atualizar Modos de gravação não são suportados (limitação de banco de dados)
  • Visualizações não são suportadas
  • Os tipos de dados a seguir não são suportados como um destino:
    • Data
    • Decimal
    • Numéricos
    • Hora
    • Registro de data e hora

 

MySQL

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMmysql00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.0466 (B1697, U1497)

  • Nome do banco de dados
  • Nome do Host
  • Número da porta
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor de banco de dados MySQL. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para MySQL.

Restrição para o MySQL

MySQL Community Edition Servers não são suportados.

 

Oracle

A fonte de dados Oracle pode ser usada para outros tipos de origem de dados Oracle . Por exemplo, Amazon RDS para Oracle.

Versão da biblioteca ODBC do Progress Software DataDirect: Driver OracleClient-based: lib/VMor800.so. Oracle Wire Protocol: lib/VMora00.so
Versão do arquivo ODBC do Progress Software DataDirect: Driver OracleClient-based: 07.16.0221B0572, U0414). Oracle Protocolo de Ligação: 08.02.3140 (B2076, U1885)

  • Nome do Host
  • Número da porta
  • Nome do serviço: o nome do serviço Oracle que especifica o banco de dados.
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor de banco de dados Oracle. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para Oracle.

Visualizando dados de destino no Oracle
Se o fluxo do DataStage usar o conector ODBC como um destino e você desejar visualizar os dados, no estágio de destino, selecione Ativar identificadores entre aspas nas propriedades do estágio.

 

PostgreSQL

A origem de dados PostgreSQL pode ser utilizada para outros tipos de origem de dados PostgreSQL. Por exemplo, Amazon RDS for PostgreSQL ou IBM Cloud Databases for PostgreSQL.

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMpsql00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.2505 (B2078, U1890)

Visualizando dados de destino no PostgreSQL
Se seu fluxo do DataStage usar o conector ODBC como um destino e você desejar visualizar os dados, no estágio de destino, selecione Ativar identificadores cotados nas propriedades do estágio.

PostgreSQL com autenticação do tipo “ SSL ”
Para se conectar a um banco de dados que utilize uma porta do tipo “ SSL ”, é necessário inserir os atributos “ EncryptionMethod ” (EM) e “ ValidateServerCertificate ” (VSC) da seguinte forma no campo “Propriedades adicionais” da conexão:

EM=1;AM=1;VSC=0

 

SAP ASE

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMase00.so
Software de progresso DataDirect ODBC versão do arquivo: 07.16.0373 (B0805, U0647)

  • Nome do banco de dados
  • Endereço de rede: o nome ou endereço IP do servidor SAP ASE seguido por uma vírgula e o número da porta.
    Por exemplo, server-name,5000 ou 192.0.2.0,5000.
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor SAP ASE. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para o protocolo Wire do Sybase.

 

SAP IQ

Software de progresso DataDirect ODBC versão da biblioteca: lib/VMsyiq00.so
Software de progresso DataDirect ODBC versão do arquivo: 08.02.0279 (B2038, U1847)

  • Nome do banco de dados
  • Endereço de rede: o nome ou endereço IP do servidor SAP IQ seguido por uma vírgula e o número da porta.
    Por exemplo, server-name,5000 ou 192.0.2.0,5000.
  • Nome do usuário e senha
  • Propriedades adicionais: insira uma lista separada por ponto e vírgula de quaisquer propriedades necessárias ao servidor SAP IQ. Para conhecer as propriedades disponíveis, consulte Descrições de opção do Progress Connection para SAP IQ.

 

Teradata

Software Progress DataDirect ODBC versão da biblioteca: lib/VMtera00.so
Software Progress DataDirect ODBC versão do arquivo: 008.02.0090 ( b0481, U3184 )

  • Nome do banco de dados
  • Nome do host ou endereço IP
  • Porta
  • Mecanismo de login: LDAP ou TD2
  • Nome do usuário e senha
  • Additional properties (Propriedades adicionais): Insira uma lista separada por ponto e vírgula de quaisquer propriedades exigidas pelo servidor Teradata.
  • Caminho do arquivo de chave privado da conta do serviço

 

Saiba Mais

Conectando a uma origem de dados no DataStage