Consultar Banco de Dados

A atividade Consultar Banco de Dados consulta um banco de dados e retorna as linhas resultantes como dados publicados. Essa atividade oferece suporte aos seguintes tipos de banco de dados:

• Acesso

• ODBCODBC

• Oráculo

• SQL Server

A atividade Consultar Banco de Dados pode ser usada para consultar um banco de dados para obter a descrição detalhada de um código de erro que apareceu em um dos sistemas no data center e, em seguida, essa descrição é enviada a um administrador em uma mensagem de email.

Configurar a atividade do banco de dados de consulta

Antes de configurar a atividade Query Database, você precisará determinar o seguinte:

• O banco de dados ao qual você está se conectando

• A consulta SQL que você está executando

Use as informações a seguir para configurar a atividade Banco de Dados de Consulta.

Detalhes

Configurações	Instruções de configuração
Consulta	Insira a consulta SQL no campo Consulta

Aviso

A atividade Banco de Dados de Consulta não oferece suporte a consultas que retornam dados como XML, como consultas que usam a cláusula FOR XML no SQL Server.

Conexão

Configurações	Instruções de configuração
Tipo de banco de dados	Clique em Banco de dados na lista suspensa. As opções incluem o seguinte: – Acesso - ODBC – Oracle – SQL Server

Importante

Quando o Orchestrator é instalado em um sistema operacional diferente do inglês e você define o tipo de conexão para banco de dados como SQL Server, o valor de entrada do servidor não pode ser localhost. Você deve usar o nome real do computador.

As instruções de configuração para cada guia de ConexãoTipo de banco de dados estão listadas nas tabelas a seguir.

Conexões de acesso

Configurações	Instruções de configuração
Arquivo	Digite o nome do arquivo de banco de dados do Access que você deseja acessar.
Arquivo de grupo de trabalho	Insira o nome do arquivo do grupo de trabalho do Access associado a esse banco de dados.
Nome de usuário	Insira o nome de usuário para o arquivo do grupo de trabalho.
Senha	Digite a senha do arquivo do grupo de trabalho.
Senha do banco de dados	Digite a senha do banco de dados do Access.

Conexões ODBC

Configurações	Instruções de configuração
DSN	Insira o nome da fonte de dados.
Nome de usuário	Insira o nome de usuário para esse banco de dados.
Senha	Digite a senha para este banco de dados.

Conexões Oracle

Configurações	Instruções de configuração
Nome do Serviço	Insira o nome do serviço.
Nome de usuário	Insira o nome de usuário para esse banco de dados.
Senha	Digite a senha para este banco de dados.

Conexões do SQL Server

Observação

MSOLEDB19 driver é usado para estabelecer conexões criptografadas com o SQL Server (por padrão). Se o certificado do SQL Server não for Confiável no computador do Orchestrator, insira Server=<serverName>;Trust Server Certificate=True para cada configuração. Saiba mais para instalar um certificado do SQL Server.

Configurações	Instruções de configuração
Autenticação	Selecione Autenticação do Windows ou Autenticação do SQL Server.
Servidor	Insira o nome do SQL Server que você deseja acessar.
Catálogo inicial	Insira o nome do catálogo inicial. Se você selecionou a opção Autenticação do SQL Server, insira o nome de usuário e a senha usados para acessar o SQL Server nas caixas Nome de usuário e Senha.

Tempo limite

Configurações	Instruções de configuração
Tempo Limite	Insira a quantidade de tempo que a atividade Consultar Banco de Dados aguardará a conclusão da operação do banco de dados. Defina esse valor como 0 para aguardar indefinidamente.

Credenciais de Segurança

Configurações	Instruções de configuração
Usar a segurança da conta atribuída ao serviço	Selecione essa opção se quiser executar a atividade Banco de Dados de Consulta usando a mesma conta que o servidor runbook usa.
Esta conta	Use essa opção para especificar uma conta diferente. Insira o nome de Usuário e a Senha. Observação: Se você especificar um nome de usuário ou senha inválidos, a conta atribuída ao servidor runbook será usada para executar a atividade.

Dados publicados

A tabela a seguir lista os itens de dados publicados.

Elemento	Descrição
Valor de retorno numérico da consulta	Quando uma consulta que retorna um valor numérico é usada, esse será o valor. Por exemplo, "Selecione COUNT(*) onde PrimeiroNome=John"
Consulta do banco de dados	A consulta do banco de dados que foi enviada ao banco de dados.
Catálogo Inicial	O catálogo inicial que foi usado ao se conectar ao banco de dados. Esses dados publicados só estarão disponíveis quando SQL Server for selecionado na guia Conexão.
Servidor de banco de dados	O nome do servidor de banco de dados. Esses dados publicados só estarão disponíveis quando SQL Server for selecionado na guia Conexão.
Usuário de banco de dados	O nome do usuário usado para se conectar ao servidor de banco de dados.
ODBC DSN	O nome do ODBC DSN. Esses dados publicados só estarão disponíveis quando o ODBC for selecionado na guia Conexão.
Nome do Serviço Oracle	O nome do serviço. Esses dados publicados só estarão disponíveis quando o Oracle for selecionado na guia Conexão.
Acessar arquivo	O arquivo de banco de dados do Access que foi consultado. Esses dados publicados só estarão disponíveis quando o Access for selecionado na guia Conexão.
Acessar arquivo de informações do grupo de trabalho	O arquivo de grupo de trabalho do Access associado ao arquivo de banco de dados do Access. Esses dados publicados só estarão disponíveis quando o Access for selecionado na guia Conexão.
Para cada linha publicada
Linha inteira como uma string com campos separados por ;	A linha inteira foi publicada com cada campo separado por ponto-e-vírgula (;). Use a função Manipulação de dados de campo para obter os valores de um campo dentro da linha