Utilización de una cadena de conexión

4D v16

Cuando se utiliza la API ODBC en PHP, con un script Python, Java, C, C ++ o cualquier lenguaje de programación, puede conectarse sin necesidad de utilizar un DSN por medio de una cadena de conexión.

Ejemplo utilizando Python:

import pyodbc

conn = pyodbc.connect(‘Driver={4D ODBC Driver 32-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 ejemplo utiliza las siguientes palabras claves:

Driver: definido para utilizar el driver 4D ODBC 32 bits
Server: definido para utilizar el 4D Server en la máquina con la dirección IP= "187.145.45.23"; no se especifica ningún puerto, se utilizará el puerto por defecto (19812).
UID y PWD: definido para conectar como "Diseñador" utilizando "123456" como contraseña.

Las palabras claves no distinguen entre mayúsculas y minúsculas y se pueden utilizar en cualquier orden, con la excepción de "Driver", que debe ser lo primero, si se utiliza. Cuando no se especifica una palabra clave, se utiliza el valor predeterminado.

Una cadena de conexión también puede utilizar un DSN. Al crear un DSN usando la ventana de configuración de 4D, se guarda la configuración en el registro o en el archivo odbc.ini utilizando las mismas palabras claves.

Por ejemplo, si utiliza la cadena de conexión:

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

... es el equivalente de una cadena de conexión usando los mismos valores definidos en el DSN 'My_4D_DSN' DSN.

Una descripción de todas las palabras claves utilizadas en una cadena de conexión, o al configurar un DSN, se muestra a continuación.

Palabras claves

Driver
Identifica el ODBC Driver utilizado.
Para una cadena de conexión: utilice el valor "{4D ODBC Driver 32-bit}" o "{4D ODBC Driver 64-bit}"
Para una definición DSN (OS X): utilice "/Library/ODBC/4D ODBC x32.bundle/Contents/MacOS/4D ODBC x32" o "/Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64" en el archivo obdc.ini o en la configuración para llave/valor DSN genérica.
DSN
Para una cadena de conexión: indica un DSN a utilizar.
En este caso, no es necesario utilizar otras palabras claves desde que se definieron en el DSN.
Para una definición DSN: usted asigna un nombre directamente y no necesita una palabra clave.
Descripción
Para una cadena de conexión: esta palabra clave no se utiliza.
Para una definición DSN: puede introducir una descripción corta (opcional).
Valor por defecto: ""
Server
Indica la dirección IP o el nombre del servidor 4D al cual usted desea conectarse. Ejemplos: "127.0.0.1", "localhost", "2001:0db8:0000:85a3:0000:0000:ac1f:8001".
Valor por defecto: “localhost”.
Port
Especifica el puerto de conexión.
Valor por defecto: 19812
Este puerto debe ser el mismo que el que se proporciona en la página SQL/Página de configuración de las Propiedades de la base (en el equipo servidor).
UID
Identifica el nombre del usuario bajo el cual se conectará.
Valor por defecto: ""
PWD
Ofrece la contraseña asociada con el nombre de usuario especificado en la clave UID.
Valor por defecto: ""
SSL
Activa una conexión TLS.
Para una cadena de conexión: puede ser "True" o "False"
Para una definición DSN: aparece como una casilla de selección
Valor por defecto: "False"
PhysicalConnectionTimeout*
Una conexión ODBC comienza mediante la conexión a la red TCP/IP.
Este valor establece el tiempo de espera para este paso.
Valor por defecto: 0
LoginTimeout*
Una vez que el driver está conectado a la red TCP/IP, a continuación, debe ser reconocido por el servidor 4D. Por lo tanto, envía un marco que contiene el usuario, la contraseña y otra información. Este tiempo de espera establece el tiempo máximo de espera por una respuesta.
Valor por defecto: 0
QueryTimeout*
Una vez un driver ODBC esté conectado, también puede ejecutar consultas y manipular datos. Este tiempo de espera, expresado en segundos, se aplica en este caso.
Valor por defecto: 0

* Los Timeouts definen el tiempo de espera antes de abortar una acción. Sus valores se expresan en segundos, con 0 siendo tiempo de espera ilimitado.
DefaultPageSize (configuración avanzada):
Valor expresado en filas.
NetworkCacheSize (configuración avanzada):
Valor expresado en KB.
FavouriteImageFormats (configuración avanzada):
Para una cadena de conexión: contiene una lista de formatos imagen aceptados, separados por espacios, elegidos de entre los siguientes: .tiff, .gif, .jpg, .png, .bmp.
Valor por defecto: "" (acepta todo formato imagen)
CharsEncoding (configuración avanzada):
Para una cadena de conexión: puede ser "UTF-8" o "System".
Para una definición de DSN: mostrado como un botón de radio
Valor por defecto: UTF-8
OpenQuery (configuración avanzada):
Para una cadena de conexión: utilice "True" o "False". Si utiliza SQLServerManagementStudio y experimenta dificultades para conectarse a 4D, es preferible ejecutar el siguiente 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 una definición de DSN: aparece como una casilla de selección
Valor por defecto: False (no seleccionado)
MSAccess (configuración avanzada):
Para una cadena de conexión: utilice "True" o "False". Si tiene problemas con las fechas y horas, puede intentar definir esta opción como "True".
Para una definición de DSN: aparece como una casilla de verificación
Valor por defecto: False (no seleccionado)
Windev (configuración avanzada):
Para una cadena de conexión: utilice "True" o "False". Si encuentra problemas con Windev, puede intentar definir esta opción como "True".
Para una definición de DSN: aparece como una casilla de selección
Valor por defecto: False (no seleccionado)