Configurar Instrução SQL

Para abrir a janela Configurar Instrução SQL, siga estas etapas:

1. Em uma sessão de Exibição 3270, sessão de Exibição 5250 ou sessão de Exibição VT, clique em Ações > Dados de Transferência > Receber Dados do Host.
2. Na janela Receber Dados do Host, clique em Novo.

A janela Configurar Instrução SQL possui duas seções principais: uma seção de instrução e uma seção de resultado.

A seção de instrução ocupa a área superior da janela e inclui os seguintes campos: URL do Banco de Dados, Identificador do Driver, Classe do Driver, ID do Usuário, Senha e Instrução. Para alterar o conteúdo de um desses campos, mova o cursor de texto para o campo e digite o texto que desejar.

A seção resultante ocupa a área inferior da janela e inclui os campos restantes: Resultado da Saída para, Nome do Arquivo, Tipo de Arquivo, Sobrescrever e Anexar. É possível utilizar os campos nesta seção para gravar os dados resultantes de uma instrução SQL Select em um arquivo. (Por padrão, o Host On-Demand envia os dados resultantes de uma instrução SQL Select para a exibição.)

Informações sobre salvamento e reabertura de instruções SQL:

• Você pode configurar e salvar uma instrução SQL em uma das duas janelas:
  • Na janela Configurar SQL ou
  • No Assistente para SQL
• No entanto, você não pode transferir as informações configuradas do Assistente para SQL para a janela Configurar Instrução SQL.
• Além disso, quando você Abrir uma instrução SQL anteriormente salva, (isso é feito clicando em Abrir na janela Receber Dados do Host) o Host On-Demand abre a instrução na mesma janela na qual você a salvou. Portanto:
  • Se você configurou e salvou a instrução SQL na janela Configurar Instrução SQL, o Host On-Demand abrirá a instrução SQL anteriormente salva na janela Configurar Instrução SQL.
  • Por outro lado, se você configurou e salvou a instrução SQL no Assistente para SQL, o Host On-Demand abrirá a instrução SQL anteriormente salva no Assistente para SQL.

Assistente para SQL

Clique em Assistente para SQL para abri-lo. Com o Assistente para SQL, é possível criar uma instrução SQL, testá-la, exibir os resultados e salvá-la. Siga estas etapas para utilizar o Assistente para SQL:

1. Clique em Assistente para SQL.
2. A janela Configurar Instrução SQL é fechada.
3. O Assistente para SQL é aberto.
   • Se você ou seu administrador do Host On-Demand especificou quaisquer valores padrão para os Padrões de Transferência de Dados, o Host On-Demand utilizará esses valores para inicializar os campos apropriados no Assistente para SQL (consulte Padrões de Transferência de Dados).
4. Utilize o Assistente para SQL para realizar as tarefas necessárias. Você pode:
   • Efetuar logon em um servidor do banco de dados remoto.
   • Visualizar os nomes dos esquemas e tabelas disponíveis.
   • Criar uma instrução SQL.
   • Executar a instrução SQL e visualizar os resultados.
5. Se você quiser salvar a instrução SQL criada no Assistente para SQL, será possível executar uma das seguintes ações:
   • Se você estiver executando um navegador Java 1:
     • Na guia SQL do Assistente para SQL, clique em Salvar SQL ou
     • Na guia Resultados do Assistente para SQL, clique em Salvar SQL.
   • Se estiver executando um navegador ativado para Java 2:
     • Na guia Rever do Assistente para SQL, clique em Salvar ou
     • Na guia Resultados do Assistente para SQL, clique em Salvar SQL.
   O Host On-Demand salva a instrução SQL dentro da definição de sessão atual. A instrução SQL aparece na subárvore Sessão Atual da janela Receber Dados do Host.
6. Quando estiver pronto para fechar o Assistente para SQL, clique em Cancelar. Se a instrução SQL não estiver salva, ela será perdida.

Você não pode copiar as informações de configuração do Assistente para SQL para a janela Configurar Instrução SQL.

Quando você abrir uma instrução SQL salva anteriormente no Assistente para SQL, o Host On-Demand abrirá a instrução SQL no Assistente para SQL (consulte Informações sobre Salvamento e Reabertura da Instruções SQL).

URL do Banco de Dados

Digite uma URL de banco de dados (consulte Especificando uma URL de banco de dados).

Identificador do Driver

A caixa de listagem inclui os nomes de todos os drivers JDBC que foram registrados com o Host On-Demand. Expanda a caixa de listagem e clique no nome do driver JDBC registrado que você deseja utilizar ou clique em Outros para especificar outros driver.

Para obter informações gerais sobre como utilizar um driver JDBC com o cliente do Host On-Demand, consulte Registrando um Driver JDBC.

Classe do Driver

O nome completo da classe Java do driver JDBC.

• Se, no campo Identificador do Driver, você tiver selecionado o nome de um driver registrado, o Host On-Demand exibirá o nome da classe no campo Classe do Driver e não permitirá que você o modifique.
• Mas se, no campo Identificador do Driver, você selecionou Outro, deverá digitar o nome completo da classe do driver no campo Classe do Driver. A utilização de letras maiúsculas e minúsculas é significativa (COM é diferente de com). Se você não souber o nome completo da classe, entre em contato com o fornecedor do driver.

ID do Usuário

O ID do usuário necessário para acessar o banco de dados (se necessário.)

Senha

A senha do usuário necessária para acessar o banco de dados (se necessária.) Quando você digita uma senha (como mypass) no campo Senha, o Host On-Demand exibe a senha utilizando asteriscos (****** ).

Instrução

A instrução SQL que você deseja enviar ao servidor do banco de dados. É possível criar os mesmos quatro tipos de instruções SQL disponíveis no Assistente para SQL:

• Selecionar
• Inserir
• Update
• Delete

O Host On-Demand não verifica a validade do formato da instrução SQL. Se o formato da instrução SQL for inválido, ocorrerá um erro de tempo de execução quando o Host On-Demand processar a instrução SQL e o Host On-Demand exibirá uma mensagem de erro.

Resultado da Saída Para

Seleciona o destino da saída dos dados resultantes de uma instrução SQL:

• Exibir
  O Host On-Demand exibe os dados na janela Resultados da Consulta. Essa opção é o padrão.
• Arquivo
  O Host On-Demand grava os dados em um arquivo.
  • Digite o caminho do arquivo no campo Nome do Arquivo. Nota: É necessário especificar um caminho e nome de arquivo completos, incluindo a letra da unidade, se houver (por exemplo, c:\Documents and Settings\user1\output.txt).
  • Expanda a caixa de listagem Tipo de Arquivo e clique em um tipo de arquivo de banco de dados.
  • Clique em Sobrescrever para sobrescrever o arquivo existente ou em Anexar para anexar nele.

Nome do Arquivo

Se a instrução SQL for uma instrução SQL Select:

• Se você quiser enviar os dados decorrentes da instrução SQL Select para a exibição, deixe esse campo em branco.
• Se você quiser enviar os dados decorrentes da instrução SQL Select para um arquivo, digite o caminho e o nome do arquivo nesse campo ou clique em Procurar para selecionar um arquivo já existente.

Se a instrução SQL for uma instrução SQL Insert, Update ou Delete, ignore esse campo.

Tipo de Arquivo

Clique no tipo de banco de dados que deseja para o arquivo de saída. Ignore esse campo, se o tipo da instrução SQL for Insert, Update ou Delete.

Quando o tipo do arquivo é HTML ou XML, o Host On-Demand tem opções adicionais (como borda da tabela, espaçamento de células e outros para arquivos no formato HTML e XML e codificação de caracteres para arquivos XML) com valores padrão que você pode modificar no Assistente SQL (na guia Saída) mas que você não pode modificar na janela Configurar Instrução SQL (você obtém os valores padrão).

Os valores padrão são:

• Para HTML:
  -- Alinhamento à esquerda, Incluir borda, Incluir títulos de colunas e muitas outras opções menores de exibição.
  
• Para XML:
  -- Formato XML do Excel com codificação Unicode UTF-8

Se deseja definir uma destas opções para algum valor diferente do padrão, utilize o Assistente SQL para construir a instrução SQL (consulte Informações sobre salvar e reabrir instruções SQL) e especifique os valores que desejar (no Assistente SQL, clique na guia Saída, selecione Arquivo, selecione HTML ou XML e, em seguida, clique em Definições). Ao executar a instrução SQL, o Host On-Demand utiliza os valores que você especificar.

Sobrescrever, Anexar

Clique em Sobrescrever para sobrescrever o conteúdo de um arquivo existente ou clique em Anexar para anexar os dados a um arquivo existente. Se o arquivo não existir, qualquer uma das opções Sobrescrever ou Anexar criará o novo arquivo. Ignore esse campo, se o tipo da instrução SQL for Insert, Update ou Delete.

Executar

Clique em Executar para executar a instrução SQL. Os resultados da execução de uma instrução SQL a partir dessa janela são os mesmos como quando você clica em Executar na janela Receber Dados do Host (consulte Executar ).

Salvar

Clique em Salvar para armazenar a instrução SQL dentro da definição de sessão atual. A instrução SQL aparece na subárvore Sessão Atual da janela Receber Dados do Host.

Quando você abrir uma instrução SQL salva anteriormente na janela Configurar Instrução SQL, o Host On-Demand abrirá a instrução SQL na janela Configurar Instrução SQL (consulte Informações sobre Salvamento e Reabertura da Instruções SQL).

A janela Configurar Instrução SQL possui muitos dos mesmos campos como a janela SQLQuery no Editor da Macro. Para obter detalhes adicionais sobre esses campos, consulte Ação SQLQuery no Guia de Programação de Macros.

Tópicos relacionados:

• Receber Dados do Host
• Resultados da Consulta
• Ação SQLQuery (<sqlquery> elemento) Guia de Programação de Macros
• Enviar Dados para o Host
• Padrões de Transferência de Dados
• Visão Geral de Acesso ao Banco de Dados