Variables de entorno de Mainframe Connector

En esta página se enumeran todas las variables de entorno que admite Mainframe Connector. En función de la versión de Mainframe Connector, es posible que no se admitan algunas variables. Para obtener más información, consulta la columna Disponible a partir de la versión de la siguiente tabla.

Nombre Valor predeterminado Disponible a partir de la versión Descripción
True 5.8.0 Elimina los espacios en blanco al final de las cadenas. Ten en cuenta que las cadenas que solo constan de espacios en blanco se tratan como cadenas vacías.
cp037 5.8.0 Especifica la codificación de caracteres que se usa para codificar y decodificar.
False 5.10.0 Configura bq query para que se ejecute en modo remoto.
False 5.11.0 Habilita la compatibilidad con cadenas de caracteres de longitud variable si se le asigna el valor True.
-LEN 5.11.0 Es relevante si se define BQSH_FEATURE_VARIABLE_LENGTH_ENABLED. Representa el sufijo del primer parámetro de la estructura de caracteres de longitud variable. De forma predeterminada, el sufijo es -LEN. Si quieres usar otro sufijo, asigna a esta variable de entorno el sufijo que quieras.
-TEXT 5.11.0 Es relevante si se define BQSH_FEATURE_VARIABLE_LENGTH_ENABLED. Representa el sufijo del segundo parámetro de la estructura de caracteres de longitud variable. De forma predeterminada, el sufijo es -TEXT. Si quieres usar otro sufijo, asigna a esta variable de entorno el sufijo que quieras.
- 5.11.0/5.13.0 (5.13.0 y versiones posteriores) Define los valores de los tipos de datos de fecha, marca de tiempo e indicador nulo.

Usa el siguiente formato para definir el indicador nulo: SUFFIX_NULL_INDICATOR_NAME="command --null-value NULL_VALUE --not-null-value NOT_NULL_VALUE"

Usa el siguiente formato para definir la fecha y la marca de tiempo: SUFFIX_SUFFIX_NAME="command --format FORMAT --timezone TIMEZONE"

Para obtener más información, consulta Compatibilidad con campos de fecha y marca de tiempo y Compatibilidad con campos de indicador nulo.

(5.11.0 y versiones posteriores) Define los valores de los tipos de datos de fecha y marca de tiempo. Puedes asignar a esta variable de entorno cualquier valor con el siguiente formato: SUFFIX_SUFFIX_STRING="--bqtype TYPE --format FORMAT --timezone TIMEZONE"
Verdadero 5.12.0 Sustituye los guiones de los nombres de los campos de COPYBOOK por guiones bajos en los nombres de los campos correspondientes de BigQuery.
Verdadero 5.12.0 Exporta cadenas con una longitud de 0 como nulas a BigQuery. Si asigna el valor BQSH_FEATURE_EMPTY_STRING_AS_NULL a false, una cadena vacía seguirá siendo una cadena vacía cuando se exporte a BigQuery (no se le asignará el valor null).
Falso 5.12.1/5.13.0 (5.13.0 y versiones posteriores) Le permite aplicar una gestión de errores más estricta, como se indica a continuación:
  • Genera un error al analizar los tipos de fecha y marca de tiempo que contienen espacios (o que son fechas o marcas de tiempo no válidas).
  • Genera un error al decodificar un byte no válido en un tipo decimal empaquetado o un tipo decimal zonificado. Esto incluye los valores que solo contienen valores nulos, espacios o bytes altos.

(5.12.1 y versiones posteriores) Te permite aplicar una gestión de errores más estricta, como se indica a continuación:
  • Genera un error al analizar los tipos de fecha y marca de tiempo que contienen espacios (o que son fechas o marcas de tiempo no válidas).
  • Genera un error al decodificar un byte no válido en un tipo decimal empaquetado. Si un valor solo contiene valores nulos (0x00) o espacios (0x40), se decodifica como nulo y no genera un error para el decimal empaquetado, aunque esta marca esté definida como true.
Verdadero 5.13.0 Especifica que los valores que solo contengan caracteres nulos (0x00), espacios (0x40) o bytes altos (0xFF) se deben decodificar como nulos y no deben generar un error en los tipos decimal empaquetado y decimal zonificado. Esta marca solo tiene efecto si se le asigna el valor true a BQSH_FEATURE_FAIL_ON_INVALID_DATA. De lo contrario, no afectará al comportamiento de los decodificadores ni de los codificadores.
Falso 5.13.0 Aumenta o reduce el tamaño de la ventana del control de flujo de HTTP/2.
Verdadero 5.14.0 Si no se define o se define como true, los campos DISPLAY, NATIONAL, DBCS y UTF8 interpretan los bytes nulos como un indicador de fin de cadena e ignoran los bytes restantes. Si se le asigna el valor false, los bytes nulos se decodifican según el conjunto de caracteres utilizado.
Cadena vacía 5.14.0 Define la ruta a un conjunto de caracteres personalizado. Si quieres usar varios conjuntos de caracteres, puedes proporcionar las rutas a varios conjuntos de caracteres separados por el delimitador de punto y coma. Por ejemplo, export BQSH_FEATURE_CUSTOM_CHARSET=path1;path2.
Falso 5.15.0 Inhabilita Google Analytics.
Falso 5.15.1 Rellena los campos de FILLER en una operación de exportación de BigQuery. Si asignas el valor true a BQSH_FEATURE_RESPECT_FILLER_ON_EXPORT, Mainframe Connector asigna valores FILLER en función de los resultados de la consulta de BigQuery. Por ejemplo, SELECT f1, '|', f2 … from TABLE. En este caso, el valor de FILLER será |.