Configuração da fonte de dados

4D v20 R8

Quando utilizar a API ODBC em PHP, com um script Python, Java, C, C ++ ou qualquer linguagem de programação, pode se conectar sem necessidade de utilizar um DSN por meo de uma string de conexão.

Exemplo utilizando Python:

import pyodbc
conn = pyodbc.connect(‘Driver={4D ODBC Driver 64-bit} ;Server=187.145.45.23 ;UID=Designer ;PWD=123456’)
curs = conn.cursor()
curs.execute('select (id,name) from table_1')
curs.fetchone()
curs.close()
conn.close()

Este exemplo utiliza as seguintes palavras chaves:

Driver: definido para utilizar o driver 4D ODBC
Server: definido para utilizar o 4D Server na máquina com o endereço IP= "187.145.45.23"; não se especifica nenhuma porta, se utilizará a porta padrão (19812).
UID e PWD: definido para conectar como "Designer" utilizando "123456" como senha.

As palavras chaves não diferenciam entre maiúsculas e minúsculas e podem ser utilizadas em qualquer ordem, com exceção de "Driver", que deve ser o primeiro, se for utilizado. Quando não é especificada uma palavra chave, se utiliza o valor predeterminado.

Uma string de conexão também pode utilizar um DSN. Ao criar um DSN usando a janela de configuração de 4D, se salva a configuração no registro ou no arquivo odbc.ini utilizando as mesmas palavras chaves.

Por exemplo, se utilizar a string de conexão:

conn=pyodbc.connect('DSN=My_4D_DSN')

... é o equivalente de uma string de conexão usando os mesmos valores definidos no DSN 'My_4D_DSN' DSN.

Uma descrição de todas as palavras chaves utilizadas em uma string de conexão, ou ao configurar um DSN, se mostra a seguir.

Palavras chaves

Driver
Identifica o ODBC Driver utilizado.
Para uma cadeia de conexão: utilize o valor "{4D ODBC Driver 64-bit}"
Para uma definição DSN (OS X): utilize "/Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64" no arquivo obdc.ini ou na configuração para chave/valor DSN genérica.
DSN
Para uma cadeia de conexão: indica um DSN a utilizar.
Neste caso, não é necessário utilizar outras palavras chaves desde que se definiram no DSN.
Para uma definição DSN: você atribui um nome diretamente e não necessita uma palavra chave.
Descrição
Para uma cadeia de conexão: esta palavra chave não se utiliza.
Para uma definição DSN: pode introduzir uma descrição curta (opcional).
Valor por padrão: ""
Server
Indica o endereço IP ou o nome do servidor 4D ao qual você deseja se conectar. Exemplos: "127.0.0.1", "localhost", "2001:0db8:0000:85a3:0000:0000:ac1f:8001".
Valor por padrão: “localhost”.
Port
Especifica a porta de conexão.
Valor por padrão: 19812
Este porta deve ser o mesmo que o que se proporciona na página SQL/Página de configuração das Propriedades da base (na equipe servidor).
UID
Identifica o nome do usuário sob o qual será conectado.
Valor por padrão: ""
PWD
Oferece a senha associada com o nome de usuário especificado na chave UID.
Valor por padrão: ""
SSL
Ativa uma conexão TLS.
Para uma cadeia de conexão: pode ser "True" ou "False"
Para uma definição DSN: aparece como uma caixa de seleção
Valor por padrão: "False"
PhysicalConnectionTimeout*
Uma conexão ODBC começa mediante a conexão a rede TCP/IP.
Este valor estabelece o tempo de espera para este passo.
Valor por padrão: 0
LoginTimeout*
Uma vez que o driver está conectado a rede TCP/IP, a continuação, deve ser reconhecido pelo servidor 4D. Portanto, envia um marco que contém o usuário, a senha e outra informação. Este tempo de espera estabelece o tempo máximo de espera por uma resposta.
Valor por padrão: 0
QueryTimeout*
Uma vez um driver ODBC esteja conectado, também pode executar consultas e manipular dados. Este tempo de espera, expressado em segundos, é aplicado neste caso.
Valor por padrão: 0

* Os Timeouts definem o tempo de espera antes de abortar uma ação. Seus valores se expressam em segundos, com 0 sendo tempo de espera ilimitado.
DefaultPageSize (configuração avançada):
Valor expressado em filas.
NetworkCacheSize (configuração avançada):
Valor expressado em KB.
FavouriteImageFormats (configuração avançada):
Contém uma lista de formatos imagem aceitos, separados por espaços, escolhidos de entre os seguintes: .tiff, .gif, .jpg, .png, .bmp.
Valor por padrão: "" (aceita todo formato imagem)
CharsEncoding (configuração avançada):
Para uma cadeia de conexão: pode ser "UTF-8" ou "System".
Para uma definição de DSN: mostrado como um botão de rádio
Valor por padrão: UTF-8
OpenQuery (configuração avançada):
Para uma cadeia de conexão: utilize "True" ou "False". Se utilizar SQLServerManagementStudio e experimenta dificultades para se conectar a 4D, é preferível executar o seguinte script:
EXEC sp_addlinkedserver @server = '<Your name>', @srvproduct = '<Anything>', @provider = 'MSDASQL', @provstr = 'OpenQuery=true;dsn=<a 4D-defined DSN>;UID=<your 4D User>;PWD=<Password>'

Para uma definição de DSN: aparece como uma casa de seleção
Valor por padrão: False (não selecionado)
MSAccess (configuração avançada):
Para uma cadeia de conexão: utilize "True" ou "False". Se tiver problemas com as datas e horas, pode tentar definir esta opção como "True".
Para uma definição de DSN: aparece como uma casa de verificação
Valor por padrão: False (não selecionado)
Windev (configuração avançada):
    Para una cadeia de conexão: utilize "True" ou "False". Se encontrar problemas com Windev, pode tentar definir esta opção como "True".
    Para uma definição de DSN: aparece como uma caixa de seleção
    Valor padrão: False (não selecionado)