Usando variáveis de host em instruções SQL
Use variáveis de host escalares em instruções SQL integradas para representar um valor único. Variáveis de host são úteis para armazenar dados recuperados e para transmitir valores que devem ser designados ou usados para comparações.
Quando você usar variáveis de host, siga os seguintes requisitos:
- Você deve declarar o nome da variável do host no programa host antes de usá-la. As variáveis do host seguem as convenções de nomenclatura do idioma do host.
- Você pode usar uma variável de host para representar um valor de dados, mas não pode usá-la para representar um nome de tabela, exibição ou coluna. Você pode especificar nomes de tabelas, visualizações ou colunas em tempo de execução usando SQL dinâmico.
- Para usar uma variável de host em uma instrução SQL, você pode especificar qualquer nome de variável de host válido que seja declarado de acordo com as regras da linguagem do host.
- Dois pontos (:) devem preceder as variáveis de host usadas em instruções SQL para que o site Db2 possa distinguir um nome de variável de um nome de coluna. Quando as variáveis do host forem usadas fora das instruções SQL, não as preceda com dois pontos. PL/I Os programas têm as seguintes exceções: Se a instrução SQL atender a qualquer uma das seguintes condições, não preceda uma variável host ou matriz de variáveis host nessa instrução com dois pontos:
- A instrução SQL está em um programa que também contém uma instrução DECLARE VARIABLE.
- A variável host faz parte de uma expressão de cadeia de caracteres, mas a variável host não é o único componente da expressão de cadeia de caracteres.
- Para otimizar o desempenho, certifique-se de que a declaração da linguagem do host mapeie o mais próximo possível o tipo de dados dos dados associados no banco de dados.
- Para atribuições e comparações entre uma coluna Db2 e uma variável de host de um tipo de dados ou comprimento diferente, espere que ocorram conversões.
Se estiver usando o site Db2 precompiler, certifique-se de que os nomes das variáveis do host e dos arrays de variáveis do host sejam exclusivos no programa, mesmo que as variáveis e os arrays de variáveis estejam em blocos, classes, procedimentos, funções ou sub-rotinas diferentes. Você pode qualificar os nomes com um nome de estrutura para torná-los exclusivos.