4D v14.3

SQL SET PARAMETER

Página Inicial

 
4D v14.3
SQL
SQL SET PARAMETER

SQL SET PARAMETER 


 

SQL SET PARAMETER ( objeto ; paramTipo ) 
Parâmetro Tipo   Descrição
objeto  Objeto 4D in Objeto 4D a ser usado (variável, array ou campo)
paramTipo  Inteiro longo in Tipo de parâmetro

O comando SQL SET PARAMETER permite o uso do valor de uma variável, array ou campo 4D nas pedidos SQL.

Nota: também é possível inserir diretamente o nome de um objeto 4D a utilizar (variável, array ou campo) entre os caracteres << e >> no texto do pedido (ver exemplo 1). Para maior informação, consulte a seção Introdução aos comandos SQL .
  • No parâmetro objeto, passe o objeto 4D (variável, array ou campo) a utilizar no pedido
  • No parâmetro tipoParam, passe o tipo SQL do parâmetro. Pode passar um valor ou utilizar uma das seguintes constantes, localizadas no tema “SQL
    Constante Tipo Valor Comentário
    SQL param in Inteiro longo 1
    SQL param in out Inteiro longo 2 Utilizável unicamente no contexto de um procedimento armazenado SQL (entrada-saída parâmetro definido no procedimento armazenado).
    SQL param out Inteiro longo 4 Utilizável unicamente no contexto de um procedimento armazenado SQL (parâmetro saída definido no procedimento armazenado).

O valor do objeto 4D substitui ao caractere ? no pedido SQL (Sintaxe padrão). Se a solicitação contiver mais de um caractere ?, serão necessárias várias chamadas a SQL SET PARAMETER. Os valores dos objetos 4D serão atribuídos sequencialmente no pedido, de acordo com a ordem de execução dos comandos.

Atenção: Este comando se utiliza para lidar com os parâmetros passados a petição SQL. Não é possível utilizar o tipo SQL Param Out para associar um objeto 4D ao resultado de uma petição SQL. O resultado de uma petição SQL se recupera, por exemplo, utilizando o parâmetro objAssoc do comando  SQL EXECUTE (ver Introdução aos comandos SQL). O comando SQL SET PARAMETER se utiliza geralmente para definir os parâmetros passados a petição (SQL Param In); os tipos SQL Param Out e SQL Param In Out estão reservados para ser utilizados no contexto dos procedimentos armazenados SQL que podem devolver parâmetros.

Este exemplo é utilizado para executar um pedido SQL ao qual chama diretamente às variáveis 4D associadas:

 C_TEXT(MeuTexto)
 C_LONGINT(MeuInteiroLongo)
 
 SQL LOGIN("mysql";"root";"")
 SQLStmt:="insert into app_testTable (alpha_field, longint_field) VALUES (<<MeuTexto>>, <<MeuInteiroLongo>>)"
 For(vContador;1;10)
    MeuTexto:="Text"+String(vContador)
    MeuInteiroLongo:=vContador
    SQL EXECUTE(SQLStmt)
    SQL CANCEL LOAD
 End for
 SQL LOGOUT

O mesmo exemplo que o anterior, mas utilizando o comando  SQL SET PARAMETER :

 C_TEXT(MeuTexto)
 C_LONGINT(MeuInteiroLongo)
 
 SQL LOGIN("mysql";"root";"")
 SQLStmt:="insert into app_testTable (alpha_field, longint_field) VALUES (?,?)"
 For(vCounter;1;10)
    MeuTexto:="Text"+String(vContador)
    MeuInteiroLongo:=vCounter
    SQL SET PARAMETER(MyText;SQL param in)
    SQL SET PARAMETER(MyLongint;SQL param in)
    SQL EXECUTE(SQLStmt)
    SQL CANCEL LOAD
 End for
 SQL LOGOUT

Se o comando tiver sido executado corretamente, a variável Sistema OK retorna 1. Do contrário, retorna 0.

 
PROPRIEDADES 

Produto: 4D
Tema: SQL
Número 823

Este comando modifica a variável sistema OK

 
HISTÓRIA 

Criado por: 4D 2004

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)