Creación de archivos de inicialización (.ini) para el controlador JDBC versión 2.1 - Amazon Redshift

Creación de archivos de inicialización (.ini) para el controlador JDBC versión 2.1

Mediante el uso de archivos de inicialización (.ini) para el controlador JDBC versión 2.1 de Amazon Redshift, es posible especificar los parámetros de configuración en el nivel del sistema. Por ejemplo, los parámetros de autenticación del IdP federado pueden variar para cada aplicación. El archivo .ini proporciona una ubicación común para que los clientes SQL obtengan los parámetros de configuración necesarios.

Se puede crear un archivo de inicialización (.ini) del controlador JDBC versión 2.1 que contenga opciones de configuración para clientes SQL. El nombre del archivo predeterminado es rsjdbc.ini. El controlador JDBC versión 2.1 busca el archivo .ini en las siguientes ubicaciones, enumeradas según el orden de prioridad:

  • El parámetro IniFile en la URL de conexión o en el cuadro de diálogo de propiedades de conexión del cliente SQL. Asegúrese de que el parámetro IniFile contenga la ruta completa al archivo .ini, incluido el nombre de este. Para obtener información acerca del parámetro IniFile, consulte IniFile. Si el parámetro IniFile no especifica de manera correcta la ubicación del archivo .ini, se mostrará un error.

  • Variables de entorno como AMAZON_REDSHIFT_JDBC_INI_FILE con la ruta completa, incluido el nombre del archivo. Puede utilizar rsjdbc.ini o especificar un nombre de archivo. Si la variable de entorno AMAZON_REDSHIFT_JDBC_INI_FILE no especifica de manera correcta la ubicación del archivo .ini, se mostrará un error.

  • Directorio donde se encuentra el archivo JAR del controlador.

  • Directorio de inicio del usuario.

  • Directorio temporal del sistema.

Puede organizar el archivo .ini en secciones; por ejemplo, [DRIVER]. Cada una de las secciones contiene pares de valor de clave que especifican varios parámetros de conexión. Puede utilizar el parámetro IniSection para especificar una sección en el archivo .ini. Para obtener información acerca del parámetro IniSection, consulte IniSection.

A continuación, se muestra un ejemplo del formato del archivo .ini, con secciones para [DRIVER], [DEV], [QA] y [PROD]. La sección [DRIVER] puede aplicarse a cualquier conexión.

[DRIVER]
key1=val1
key2=val2

[DEV]
key1=val1
key2=val2

[QA]
key1=val1
key2=val2

[PROD]
key1=val1
key2=val2

El controlador JDBC versión 2.1 carga los parámetros de configuración desde las siguientes ubicaciones, enumeradas según el orden de prioridad:

  • parámetros de configuración predeterminados en el código de la aplicación

  • propiedades de la sección [DRIVER] del archivo .ini, en caso de estar incluidas

  • parámetros de configuración de la sección personalizada, siempre que la opción IniSection se proporcione en la URL de conexión o en el cuadro de diálogo de propiedades de la conexión del cliente SQL

  • propiedades del objeto de propiedad de conexión especificado en la llamada a getConnection

  • parámetros de configuración especificados en la URL de conexión