4D Doc Center : SQL SET OPTION

4D v13.4

SQL

SQL SET OPTION


SQL SET OPTION ( opçao ; valor )

Parâmetro	Tipo	Descrição
opçao	Inteiro longo	Número da opçaõ a estabelecer
valor	Inteiro longo, cadeia	Novo valor da opçãop

Descrição

O comando SQL SET OPTION é utilizado para modificar o valor da opção passada em opçao.

opçao pode ter um dos seguintes valores, localizados no tema “SQL”:

Constante	Tipo	Valor	Comentário
SQL Asynchronous	Inteiro longo	1	0 = Conexão crônica (valor por padrão), 1 (ou valor diferente de 0) = Conexão anacrônica
SQL Charset	Inteiro longo	100	Codificação do texto utilizada pelas petições enviadas a fontes externas (via SQL pass-through). A modificação é levada a cabo para o processo atual e a conexão atual. Valores possíveis: identificador MIBEnum (ver nota 2), cadeia "WCHAR" (ver nota 3) ou valor -2 (ver nota 4). Por padrão: 106 (UTF-8)
SQL Connection Timeout	Inteiro longo	5	Tempo máximo de espera durante a execução do comando SQL LOGIN. Este valor deve ser definido antes de abrir a conexão para que seja levado em conta. Valores possíveis: tempo em segundos Por padrão: não há timeout
SQL Max Data Length	Inteiro longo	3	Longitude máxima dos dados devolvidos
SQL Max Rows	Inteiro longo	2	Número máximo de linhas no conjunto resultante (utilizado para pré visualizações)
SQL Query Timeout	Inteiro longo	4	Tempo máximo de espera ao executar o comando SQL EXECUTE. Valores: tempo em segundos Por padrão: não há timeout

Notas:

Quando trabalha com o motor SQL interno de 4D, a opção SQL Asynchronous não tem nenhum propósito já que esse tipo de conexão sempre é Crônica.
Os números MIBEmum são referenciados nas seguintes direções: http://www.iana.org/asSegnments/character-sets.
Quando passa -2 como o valor a SQL Charset, a codificação utilizada pelo servidor SQL de 4D é adaptada automaticamente a plataforma de execução (codificação não UTF):
- em Windows, se utiliza ISO8859-1
- em Mac OS, se utiliza MAC-ROMAN.

Variáveis e conjuntos do sistema

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