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 um script de 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: Comando PASSWORD Comando SET PASSWORD Tag de análise PASSWORD 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. Nota O Analytics suporta um tamanho máximo de 30 caracteres ao especificar ou inserir uma senha de perfil do servidor, uma senha de perfil de banco de dados ou uma senha de servidor de e-mail. Especificar um valor de senha que exceda esse tamanho resulta em uma senha truncada e falha na conexão.
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: Insira o nome da primeira tabela, seguido pelos campos dessa tabela. Insira o nome da próxima tabela, seguida pelos campos dessa tabela. 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.