Comando DEFINE TABLE DB

Define uma tabela de servidor do Analytics por meio de uma conexão a uma tabela de banco de dados usando o Conector do AX. Você pode estabelecer uma conexão a um banco de dados Microsoft SQL Server, Oracle ou DB2.

Sintaxe

DEFINE TABLE DB {SOURCE perfil_banco_de_dados <PASSWORD num> <PASSWORD num> | SERVER perfil_de_servidor <PASSWORD num>} <FORMAT nome_do_formato> SCHEMA esquema <TITLED nome_tabela_acl> <PRIMARY|SECONDARY> {DBTABLE nometabela_bd FIELDS {nomes_campos|ALL} <...n> <WHERE condição> <ORDER nomes_campos>

Parâmetros

SOURCE perfil_banco_de_dados

O perfil do banco de dados do Analytics a ser usado para acessar o mecanismo de banco de dados.

Os perfis de bancos de dados contêm informações necessárias para se conectar ao mecanismo de banco de dados, incluindo:

  • uma referência ao perfil de servidor associado
  • o tipo de banco de dados
  • o nome do banco de dados
  • informações da conta do usuário

Nota

DEFINE TABLE DB somente permite conexão aos bancos de dados Microsoft SQL Server, Oracle ou DB2.

PASSWORD num

opcional

A definição de senha a ser usada.

PASSWORD num não é usado para solicitar ou especificar uma senha real. A definição de senha faz referência a uma senha previamente fornecida ou definida com o comando PASSWORD, o comando SET PASSWORD ou a tag de análise PASSWORD.

num é o número da definição de senha. Por exemplo, se as duas senhas foram previamente fornecidas ou definidas em um script, ou no agendamento de uma análise, PASSWORD 2 especifica o uso da senha nº 2.

Para obter mais informações sobre o fornecimento ou a definição de senhas, consulte:

A senha somente é necessária quando o perfil do banco de dados não contém senhas salvas. Use PASSWORD duas vezes após a palavra-chave SOURCE. A primeira senha efetua o seu login no servidor e a segunda, no banco de dados.

SERVER perfil_de_servidor

Não é mais usado.

Antes da versão 10.0 do Analytics, era usado na conexão ao ACL Edição de Servidor para z/OS. A partir da versão 10.0 do Analytics, o ACL Edição de Servidor para z/OS não é mais incluído.

FORMAT nome_do_formato

opcional

O nome de uma tabela ou arquivo de layout de tabela (.layout) do Analytics contendo o layout de tabela a ser utilizado.

SCHEMA esquema

O esquema a ser conectado. O nome do esquema deve ser entre aspas.

TITLED nome_tabela_acl

opcional

O nome da tabela do Analytics a ser criada.

nome_tabela_acl deve ser uma cadeia entre aspas. Se você omitir TITLED, o Analytics usará o nome da tabela do banco de dados. Quando você acessar mais de uma tabela por vez, o Analytics usará o nome da primeira.

PRIMARY | SECONDARY

opcional

Usar a tabela como tabela primária ou secundária em comandos multiarquivo. Se nenhuma opção for especificada, o valor padrão PRIMARY será aplicado.

DBTABLE tabela_banco_de_dados

A tabela do banco de dados que você deseja acessar. tabela_banco_de_dados deve ser uma cadeia entre aspas.

FIELDS nomes_de_campos | ALL

Os campos a serem incluídos na saída:

  • FIELDS nomes_campos usar os campos especificados

    nomes_campos deve ser uma cadeia entre aspas.

  • ALL usar todos os campos da tabela

Para usar campos de mais de uma tabela:

  1. Insira o nome da primeira tabela, seguido pelos campos dessa tabela.
  2. Insira o nome da próxima tabela, seguida pelos campos dessa tabela.
  3. Para cada tabela adicional, repita a etapa b.
DBTABLE "DSN1310" FIELDS "Campo_A Campo_B Campo_C"
DBTABLE "DSN2516" FIELDS "Campo_L Campo_M Campo_N"

Nota

Usando o Conector do AX, você pode acessar um número ilimitado de tabelas relacionadas. No entanto, não recomendamos usar mais de cinco. O tempo de processamento aumenta ao acessar várias tabelas.

WHERE condição

opcional

Uma cláusula SQL WHERE que limita os dados aos registros que atendam à condição especificada.

É preciso usar sintaxe SQL válida, inserida como uma cadeia entre aspas.

Quando você associa tabelas, o Analytics exibe a condição da associação na cláusula WHERE:

"Table_1.First_name = Table_2.First_name"
ORDER nomes_campos

opcional

Os campos que o mecanismo de banco de dados utiliza para ordenar registros. nomes_campos deve ser uma cadeia entre aspas.

O comando é mais demorado quando ordena registros. Use ORDER apenas quando a ordenação é importante.

Exemplos

Exemplo

Você quer acessar dados de um banco de dados Microsoft SQL Server usando o Conector do AX. Para isso, você usa o comando DEFINE TABLE DB. Inclua o parâmetro SOURCE para conexão ao Conector do AX por meio de um perfil de banco de dados:

DEFINE TABLE DB SOURCE "Auditoria_SQLServer" SCHEMA "RH" TITLED "Folha de Pagamento" DBTABLE "RH.Funcionário" FIELDS "IDFuncionário" DBTABLE "RH.HistóricoPagamentoFuncionário" FIELDS "Taxa FrequênciaPagamento"WHERE "RH.Funcionário.IDFuncionário=RH.HistóricoPagamentoFuncionário.IDFuncionário"

Observações

Como funciona?

A tabela do servidor do Analytics é definida como uma consulta que usa um perfil de banco de dados para se conectar a uma tabela de do banco de dados.

Supressão da parte de tempo dos valores de datahora

Preceda o comando DEFINE TABLE DB com o comando SET SUPPRESSTIME para suprimir a parte de tempo de valores de datahora.

O uso de SET SUPPRESSTIME ON é destinado a scripts do Analytics em versões anteriores à 10.0. Esses scripts pressupõem que a parte de tempo de valores de datahora será truncada. Se SET SUPPRESSTIME ON não for adicionado a esses scripts, eles não poderão ser executados na versão com suporte a datahora do Analytics.

Para obter mais informações, consulte a seção "SET SUPPRESSTIME" no Comando SET.