Administra los parámetros de configuración predeterminados

Los parámetros de configuración predeterminados en BigQuery pueden ayudar a tu organización a aplicar la seguridad, controlar los costos y optimizar el rendimiento de las consultas. Como administrador de BigQuery o propietario del proyecto, puedes especificar, quitar y recuperar estos valores predeterminados a nivel de la organización y del proyecto, o bien anularlos para sesiones y trabajos individuales.

Roles obligatorios

Para obtener los permisos que necesitas para especificar o recuperar los parámetros de configuración, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para especificar o recuperar los parámetros de configuración. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para especificar o recuperar los parámetros de configuración:

  • Especifica los parámetros de configuración: bigquery.config.update en tu organización o proyecto
  • Recuperar los parámetros de configuración: bigquery.config.get en el proyecto especificado

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre las funciones de IAM y los permisos en BigQuery, consulta Funciones y permisos predefinidos.

Especifica la configuración global

Los parámetros de configuración globales se aplican a todas las ubicaciones y no usan un prefijo region-REGION.. En cambio, la configuración regional solo se aplica a una ubicación específica. Puedes especificar la configuración global a nivel de la organización o del proyecto. La ubicación predeterminada (default_location) es el único parámetro de configuración global que puedes establecer.

Si no especificas una ubicación de forma explícita, esta se determina de una de las siguientes maneras:

  • Es la ubicación de los conjuntos de datos a los que se hace referencia en la solicitud. Por ejemplo, si una consulta hace referencia a una tabla o vista en un conjunto de datos almacenado en la región asia-northeast1, el trabajo de consulta se ejecuta en asia-northeast1.
  • Es la región especificada para una conexión a la que se hace referencia en una solicitud.
  • Ubicación de una tabla de destino.

Si la ubicación no se especifica de forma explícita y no se puede determinar a partir de los recursos de la solicitud, se usa la ubicación predeterminada. Si no se establece la ubicación predeterminada, el trabajo se ejecuta en la multirregión US.

Limitaciones

Los parámetros de configuración global están sujetos a las siguientes limitaciones:

  • La configuración global de la organización y del proyecto no se admite en las ubicaciones de BigQuery Omni. No puedes establecer default_location en una ubicación de BigQuery Omni ni configurar o ver la configuración global en una ubicación de BigQuery Omni.
  • No puedes mezclar parámetros de configuración globales y regionales en la misma declaración DDL ALTER ORGANIZATION SET OPTIONS o ALTER PROJECT SET OPTIONS.
  • Cuando modificas el parámetro de configuración global default_location, el cambio puede tardar hasta 10 minutos en propagarse. Hasta que se propague el parámetro de configuración, es posible que BigQuery enrute los trabajos que dependen de la ubicación predeterminada a la ubicación predeterminada anterior.

Establece la configuración global de la organización

Puedes establecer la configuración global a nivel de la organización con la declaración DDL ALTER ORGANIZATION SET OPTIONS. La ubicación predeterminada (default_location) es el único parámetro de configuración global que puedes establecer a nivel de la organización. Todos los demás parámetros de configuración a nivel de la organización son parámetros de configuración regionales.

La declaración DDL ALTER ORGANIZATION SET OPTIONS se aplica a la organización a la que pertenece el proyecto actual.

Para configurar el parámetro de configuración default_location a nivel de la organización, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página BigQuery.

    Ir a BigQuery

  2. Para abrir el editor de consultas, haz clic en search_insights Consulta sin título.

  3. Para configurar el parámetro default_location, ingresa la siguiente sentencia de DDL en el editor de consultas:

      ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

    Reemplaza LOCATION por una ubicación regional o multirregional de BigQuery. Este valor es la ubicación que usa BigQuery para ejecutar trabajos cuando no se puede inferir la ubicación del trabajo a partir de la solicitud, por ejemplo, cuando una consulta no hace referencia a ningún conjunto de datos ni conexión.

  4. Como alternativa, para quitar el parámetro de configuración default_location a nivel de la organización, ingresa la siguiente declaración de DDL en el editor de consultas:

      ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );

  5. Haz clic en Ejecutar.

bq

Para configurar el parámetro default_location a nivel de la organización, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente instrucción DDL como el parámetro de consulta:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Reemplaza LOCATION por una ubicación regional o multirregional de BigQuery. Este valor es la ubicación que usa BigQuery para ejecutar trabajos cuando la ubicación del trabajo no se puede inferir de la solicitud, por ejemplo, cuando una consulta no hace referencia a ningún conjunto de datos ni conexión.

Como alternativa, para quitar el parámetro de configuración default_location a nivel de la organización, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente declaración de DDL como parámetro de consulta:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );

API

Llama al método jobs.query y proporciona la declaración de DDL en la propiedad query del cuerpo de la solicitud.

Establece la configuración global del proyecto

Puedes configurar los parámetros globales a nivel del proyecto con la declaración DDL ALTER PROJECT SET OPTIONS. La ubicación predeterminada (default_location) es el único parámetro de configuración global que puedes establecer a nivel de proyecto. Todos los demás parámetros de configuración a nivel de proyecto son parámetros de configuración regionales.

La declaración DDL ALTER PROJECT SET OPTIONS acepta de forma opcional la variable PROJECT_ID. Si no especificas PROJECT_ID, la sentencia se establece de forma predeterminada en el proyecto en el que ejecutas la sentencia de DDL ALTER PROJECT.

Las configuraciones a nivel de proyecto anulan las configuraciones a nivel de organización. A su vez, las configuraciones a nivel de sesión pueden anular las configuraciones a nivel de proyecto, y las configuraciones a nivel de trabajo pueden anular las configuraciones a nivel de sesión.

Para configurar el parámetro de configuración default_location a nivel del proyecto, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página BigQuery.

    Ir a BigQuery

  2. Para abrir el editor de consultas, haz clic en search_insights Consulta sin título.

  3. Para configurar el parámetro de configuración default_location, ingresa la siguiente instrucción DDL en el editor de consultas:

      ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto.

    • LOCATION: una ubicación regional o multirregional de BigQuery. Este valor es la ubicación que usa BigQuery para ejecutar trabajos cuando la ubicación del trabajo no se puede inferir de la solicitud, por ejemplo, cuando una consulta no hace referencia a ningún conjunto de datos ni conexión.

  4. Como alternativa, para quitar el parámetro de configuración default_location a nivel del proyecto, ingresa la siguiente sentencia de DDL en el editor de consultas:

      ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );

    Si quitas el parámetro de configuración default_location a nivel del proyecto, BigQuery usará el parámetro de configuración predeterminado a nivel de la organización, si existe, o el parámetro de configuración predeterminado del sistema.

  5. Haz clic en Ejecutar.

bq

Para establecer el parámetro de configuración default_location a nivel del proyecto, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente instrucción de DDL como el parámetro de consulta:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: una ubicación regional o multirregional de BigQuery. Este valor es la ubicación que BigQuery usa para ejecutar trabajos cuando no se puede inferir la ubicación del trabajo a partir de la solicitud, por ejemplo, cuando una consulta no hace referencia a ningún conjunto de datos ni conexión.

Como alternativa, para quitar el parámetro de configuración default_location a nivel del proyecto, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente instrucción DDL como el parámetro de consulta:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );

Si quitas el parámetro de configuración default_location a nivel del proyecto, BigQuery usará el parámetro de configuración predeterminado a nivel de la organización, si existe, o el parámetro de configuración predeterminado del sistema.

API

Llama al método jobs.query y proporciona la declaración de DDL en la propiedad query del cuerpo de la solicitud.

Especifica la configuración regional

La configuración regional se aplica a una ubicación específica y requiere un prefijo region-REGION.. Puedes establecer la configuración regional a nivel de la organización o del proyecto.

Controles de reserva y facturación

Puedes configurar parámetros de configuración regionales a nivel del proyecto para controlar cómo las consultas usan las reservas o la facturación a pedido. Esta configuración ayuda a garantizar la previsibilidad de los costos, ya que permite el uso flexible de las reservas o requiere que las consultas usen ranuras de reserva.

Los controles comunes de reserva y facturación incluyen reservation_override_mode (versión preliminar) y disable_on_demand_billing (versión preliminar). Para definir estos parámetros, consulta Establece la configuración del proyecto regional. Para obtener una lista completa de las opciones de proyecto, consulta la lista de opciones de ALTER PROJECT SET OPTIONS.

Configura los parámetros de organización regionales

Puedes establecer la configuración regional a nivel de la organización con la declaración DDL ALTER ORGANIZATION SET OPTIONS. Debes especificar la región en la que se aplica cada parámetro de configuración de la organización. Solo puedes usar una región en una instrucción.

En los ejemplos de esta sección, se especifica la siguiente configuración regional predeterminada de la organización:

  • Zona horaria: America/Chicago
  • Clave de Cloud KMS: Es una clave definida por el usuario.
  • Tiempo de espera de la consulta: 30 minutos (1,800,000 milisegundos)
  • Tiempo de espera de la cola de consultas interactivas: 10 minutos (600,000 milisegundos)
  • Tiempo de espera de la cola de consultas por lotes: 20 minutos (1,200,000 milisegundos)
  • Vistas de almacenamiento de tablas y de índice de búsqueda INFORMATION_SCHEMA (enable_info_schema_storage): habilitadas

Para obtener más información sobre todos los parámetros de configuración de la organización regional, consulta organization_set_options_list.

Para establecer la configuración regional de la organización, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página BigQuery.

    Ir a BigQuery

  2. Para abrir el editor de consultas, haz clic en search_insights Consulta sin título.

  3. Para configurar los parámetros de organización regionales, ingresa la siguiente instrucción DDL en el editor de consultas:

      ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);

    Reemplaza lo siguiente:

  4. Como alternativa, para quitar la configuración regional de la organización, ingresa la siguiente instrucción DDL en el editor de consultas:

      ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

  5. Haz clic en Ejecutar.

bq

Para establecer la configuración de la organización regional, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente declaración de DDL como el parámetro de consulta:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);

Reemplaza lo siguiente:

Como alternativa, para quitar la configuración regional de la organización, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente instrucción DDL como el parámetro de consulta:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

Llama al método jobs.query y proporciona la declaración de DDL en la propiedad query del cuerpo de la solicitud.

Establece la configuración regional del proyecto

Puedes establecer la configuración regional a nivel de proyecto con la declaración DDL ALTER PROJECT SET OPTIONS. Debes especificar la región en la que se aplica cada parámetro de configuración del proyecto. Solo puedes usar una región en una instrucción.

Las configuraciones a nivel de proyecto anulan las configuraciones a nivel de organización. A su vez, las configuraciones a nivel de sesión pueden anular las configuraciones a nivel de proyecto, y las configuraciones a nivel de trabajo pueden anular las configuraciones a nivel de sesión.

La declaración DDL ALTER PROJECT SET OPTIONS acepta de forma opcional la variable PROJECT_ID. Si no especificas PROJECT_ID, la instrucción se establece de forma predeterminada en el proyecto en el que ejecutas la instrucción DDL ALTER PROJECT.

En los ejemplos de esta sección, se especifican los siguientes parámetros de configuración regionales predeterminados del proyecto:

  • Zona horaria: America/Los_Angeles
  • Clave de Cloud KMS: Es una clave definida por el usuario.
  • Tiempo de espera de la consulta: 1 hora (3,600,000 milisegundos)
  • Tiempo de espera de la cola de consultas interactivas: 10 minutos (600,000 milisegundos)
  • Tiempo de espera de la cola de consultas por lotes: 20 minutos (1,200,000 milisegundos)
  • Equidad basada en reservas: habilitada
  • Consultas globales: habilitadas para ejecutarse y acceder a los datos
  • Vistas de INFORMATION_SCHEMA del almacenamiento de tablas y el índice de la Búsqueda (enable_info_schema_storage): habilitadas

Para obtener más información sobre todos los parámetros de configuración regionales del proyecto, consulta project_set_options_list.

Para establecer la configuración regional del proyecto, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página BigQuery.

    Ir a BigQuery

  2. Para abrir el editor de consultas, haz clic en search_insights Consulta sin título.

  3. Para configurar los parámetros regionales del proyecto, ingresa la siguiente instrucción DDL en el editor de consultas:

     ALTER PROJECT PROJECT_ID
 SET OPTIONS (
 `region-REGION.default_time_zone` = 'America/Los_Angeles',
 -- Ensure all service accounts under the project have permission to KMS_KEY
 `region-REGION.default_kms_key_name` = KMS_KEY,
 `region-REGION.default_query_job_timeout_ms` = 3600000,
 `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
 `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
 `region-REGION.enable_reservation_based_fairness` = true,
 `region-REGION.enable_global_queries_execution` = true,
 `region-REGION.enable_global_queries_data_access` = true,
 `region-REGION.enable_info_schema_storage` = true);

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto.
    • REGION: La región de BigQuery asociada a tu proyecto u organización, por ejemplo, us o europe-west6. El valor de REGION debe ser el mismo para cada opción del comando.
    • KMS_KEY: Es una clave de Cloud KMS definida por el usuario. Para obtener más información, consulta Claves de Cloud KMS administradas por el cliente.

  4. Como alternativa, para quitar la configuración del proyecto regional, ingresa la siguiente sentencia de DDL en el editor de consultas:

      ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

  5. Haz clic en Ejecutar.

bq

Para establecer la configuración regional del proyecto, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente declaración de DDL como el parámetro de consulta:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = 'America/Los_Angeles',
  -- Ensure all service accounts under the project have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 3600000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_reservation_based_fairness` = true,
  `region-REGION.enable_global_queries_execution` = true,
  `region-REGION.enable_global_queries_data_access` = true,
  `region-REGION.enable_info_schema_storage` = true);

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región de BigQuery asociada con tu proyecto u organización, por ejemplo, us o europe-west6. El valor de REGION debe ser el mismo para cada opción del comando.
  • KMS_KEY es una clave de Cloud KMS definida por el usuario. Para obtener más información, consulta Claves de Cloud KMS administradas por el cliente.

Como alternativa, para quitar la configuración regional del proyecto, ingresa el comando bq query con la marca --use_legacy_sql establecida en false y proporciona la siguiente declaración DDL como el parámetro de consulta:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

Llama al método jobs.query y proporciona la declaración de DDL en la propiedad query del cuerpo de la solicitud.

Recupera los parámetros de configuración

Puedes ver los parámetros de configuración de una organización o un proyecto con las siguientes vistas de INFORMATION_SCHEMA:

Las configuraciones nuevas pueden tardar unos minutos en aplicarse y aparecer en las vistas de INFORMATION_SCHEMA.

Ejemplos de consultas para recuperar la configuración

Usa los siguientes ejemplos de consultas para recuperar la configuración de tu proyecto y organización desde las vistas de INFORMATION_SCHEMA.

Cómo ver la configuración global

Para ver todos los parámetros de configuración globales de la organización, ejecuta la siguiente consulta:

SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Para ver solo el parámetro de configuración de la organización default_location, ejecuta la siguiente consulta:

SELECT
    option_value
FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS
WHERE option_name = 'default_location'

Para ver todas las configuraciones globales efectivas de tu proyecto predeterminado, ejecuta la siguiente consulta:

SELECT * FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Para ver solo el parámetro de configuración default_location efectivo de tu proyecto predeterminado, ejecuta la siguiente consulta:

SELECT
    option_value
FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
WHERE option_name = 'default_location'

Para ver todos los parámetros de configuración globales de tu proyecto predeterminado, ejecuta la siguiente consulta:

SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;

Para ver solo el parámetro de configuración default_location de tu proyecto predeterminado, ejecuta la siguiente consulta:

SELECT
    option_value
FROM INFORMATION_SCHEMA.PROJECT_OPTIONS
WHERE option_name = 'default_location'

Consulta la configuración regional

Para ver las configuraciones en una organización en la región us, ejecuta la siguiente consulta:

SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Para ver las configuraciones efectivas en tu proyecto predeterminado en la región us, ejecuta la siguiente consulta:

SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Para ver las opciones de configuración en tu proyecto predeterminado en la región us, ejecuta la siguiente consulta:

SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Configuración predeterminada

En las siguientes secciones, se describen los parámetros de configuración que puedes especificar.

Configuración de ejecución de consultas y trabajos

Usa los siguientes parámetros de configuración para controlar cómo se ejecutan, cronometran y ponen en cola las consultas.

  • default_batch_query_queue_timeout_ms: Es la cantidad de tiempo predeterminada, en milisegundos, que una consulta por lotes espera en una cola de consultas. Si no se configura, el valor predeterminado es 24 horas. El valor mínimo es 1 milisegundo. El valor máximo es 48 horas. Para desactivar la cola de consultas por lotes, establece el valor en -1.

  • default_interactive_query_queue_timeout_ms: Es la cantidad de tiempo predeterminada en milisegundos que una consulta interactiva espera en una cola de consultas. Si no se configura, el valor predeterminado es 6 horas. El valor mínimo es 1 milisegundo y el valor máximo es 48 horas. Para desactivar la cola de consultas interactivas, establece el valor en -1.

  • default_query_job_timeout_ms: el tiempo predeterminado después del cual se agota el tiempo de espera de un trabajo de consulta, incluido el tiempo que se pone en cola y el tiempo que se ejecuta. El tiempo de espera debe ser de entre 5 minutos y 48 horas. Este tiempo de espera solo se aplica a los trabajos de consulta individuales y a los trabajos secundarios de las secuencias de comandos. Para establecer un tiempo de espera para los trabajos de secuencia de comandos, usa el método de la API jobs.insert y establece el campo jobTimeoutMs.

  • default_location: El parámetro de configuración default_location se usa para ejecutar trabajos cuando no se establece la ubicación o no se puede determinar. Si no se establece default_location, el trabajo se ejecuta en la multirregión US. Para obtener más información, consulta Cómo especificar ubicaciones.

  • enable_reservation_based_fairness: Es la opción que determina cómo se comparten los espacios inactivos. Para los proyectos de administración creados después del 10 de octubre de 2026, esta opción está habilitada (TRUE) de forma predeterminada. Para los proyectos creados antes del 10 de octubre de 2026, el valor predeterminado es FALSE, lo que significa que las ranuras inactivas se distribuyen de manera equitativa entre todos los proyectos de consulta. Si habilitas esta opción, las ranuras inactivas se comparten de forma equitativa entre todas las reservas primero y, luego, entre los proyectos de cada reserva. Para obtener más información, consulta Equidad basada en reservas. Esta opción solo se admite a nivel de proyecto. No puedes especificarlo a nivel de la organización o del trabajo.

  • default_time_zone: Es la zona horaria predeterminada que se debe usar en funciones de GoogleSQL que dependen de la zona horaria cuando no se especifica una como argumento. Esta configuración no se aplica a las tablas particionadas de columnas de unidades de tiempo (que usan UTC como la zona horaria), las transferencias de programa del Servicio de transferencia de almacenamiento ni la carga de datos con la herramienta de línea de comandos de bq. Para obtener más información, consulta Zonas horarias.

  • default_query_optimizer_options: Son las optimizaciones de consultas basadas en el historial. Esta opción puede ser una de las siguientes:

    • 'adaptive=on': Usa optimizaciones de consultas basadas en el historial.
    • 'adaptive=off': No usa optimizaciones de consultas basadas en el historial.
    • NULL (predeterminado): Usa la configuración predeterminada de optimizaciones de consultas basadas en el historial, que es equivalente a 'adaptive=on'.

  • default_sql_dialect_option: Es el dialecto de consulta en SQL predeterminado para ejecutar trabajos de consulta con la herramienta de línea de comandos de bq o la API de BigQuery. Cambiar este parámetro de configuración no afecta el dialecto predeterminado en la consola. Esta opción puede ser una de las siguientes:

    • 'default_legacy_sql' (predeterminado): Usa SQL heredado si el dialecto de la consulta no se especifica a nivel del trabajo.
    • 'default_google_sql': Usa GoogleSQL si no se especifica el dialecto de la consulta a nivel del trabajo.
    • 'only_google_sql': Usa GoogleSQL si el dialecto de la consulta no se especifica a nivel del trabajo. Rechaza los trabajos con el dialecto de consulta configurado como SQL heredado.
    • NULL: Usa el parámetro de configuración predeterminado del dialecto de la consulta, que es equivalente a 'default_legacy_sql'.

  • enable_global_queries_execution: Es la opción que determina si se pueden ejecutar las consultas globales. El valor predeterminado es FALSE, lo que significa que las consultas globales no están habilitadas.

  • enable_global_queries_data_access: Es la opción que determina si las búsquedas globales pueden acceder a los datos almacenados en la región. El valor predeterminado es FALSE, lo que significa que las consultas globales no pueden copiar datos de esta región, independientemente del proyecto en el que se ejecuten.

  • reusable_column_aliases_mode: Es la opción que determina si los alias de columna reutilizables están habilitados para las consultas. El valor predeterminado es off, lo que significa que los alias de columna reutilizables no están habilitados. Para obtener más información, consulta Alias de columnas reutilizables.

Configuración de administración de datos

Usa los siguientes parámetros de configuración para definir reglas de creación, seguridad y ciclo de vida de los datos.

  • default_column_name_character_map: el alcance y el manejo predeterminados de los caracteres en los nombres de las columnas. Si no se configuran, los trabajos de carga que usan caracteres no compatibles en los nombres de las columnas fallarán con un mensaje de error. Es posible que algunas tablas más antiguas se configuren para reemplazar los caracteres no compatibles en los nombres de las columnas. Para obtener más información, consulta load_option_list.

  • default_data_policy_projects: Es la lista predeterminada de proyectos cuyas políticas de datos se evalúan cuando se accede a columnas protegidas por etiquetas de administración de datos. De forma predeterminada, solo se evalúan las políticas de datos del proyecto de la tabla. Cuando configuras un proyecto de política de datos predeterminado a nivel de la organización, BigQuery evalúa tanto las políticas de datos del proyecto de la tabla como las del proyecto de política de datos predeterminado. Si existen políticas en conflicto en ambos proyectos, las políticas de datos del proyecto de la tabla tienen prioridad. Solo puedes configurar este parámetro a nivel de la organización con la instrucción ALTER ORGANIZATION SET OPTIONS, por ejemplo, region-us.default_data_policy_projects = ["my_default_project"]. Para obtener más información, consulta Configura un proyecto de política de datos predeterminado.

  • default_kms_key_name: la clave predeterminada de Cloud Key Management Service para encriptar los datos de tablas, incluidas las tablas temporales o anónimas. Para obtener más información, consulta Claves de Cloud KMS administradas por el cliente.

  • default_max_time_travel_hours: Es el período de viaje en el tiempo predeterminado en horas para los conjuntos de datos nuevos. Esta duración debe estar dentro del rango de 48 a 168, inclusive, y debe ser divisible por 24. Cambiar las horas máximas predeterminadas de los viajes en el tiempo no afecta a los conjuntos de datos existentes. Para obtener más información, consulta Viaje en el tiempo y retención de datos.

  • enable_info_schema_storage: Es la opción que proporciona acceso a las vistas INFORMATION_SCHEMA.TABLE_STORAGE y SEARCH_INDEXES, y sus variantes. De forma predeterminada, esta opción no está habilitada. Si consultas estas vistas por primera vez sin establecer esta opción en TRUE, la consulta fallará y proporcionará instrucciones para habilitar la opción. Después de habilitar esta opción, las consultas se realizan de inmediato y devuelven los datos generados a partir de ese momento. Un reabastecimiento completo de los datos históricos puede tardar aproximadamente un día en estar disponible en las vistas. Si usaste estas vistas antes de que se introdujera este parámetro de configuración, esta opción ya está habilitada.

Configuración de costos y recursos

Usa los siguientes parámetros de configuración para determinar cómo se facturan y conectan los recursos.

  • default_storage_billing_model: Es el modelo de facturación de almacenamiento predeterminado para conjuntos de datos nuevos. Establece el valor en PHYSICAL para usar bytes físicos cuando se calculan los cargos de almacenamiento, o en LOGICAL para usar bytes lógicos. Cambiar el modelo de facturación de almacenamiento predeterminado no afecta a los conjuntos de datos existentes. Para obtener más información, consulta Modelos de facturación de almacenamiento.
  • default_cloud_resource_connection_id: Es la conexión predeterminada que se usará cuando crees tablas y modelos. Especifica solo el ID o el nombre de la conexión, y excluye los prefijos de región y de ID del proyecto adjuntos. Cuando usas conexiones predeterminadas, BigQuery puede actualizar los permisos otorgados a la cuenta de servicio de la conexión, según el tipo de tabla o modelo que crees. Para obtener más información, consulta la descripción general de la conexión predeterminada.
  • reservation_override_mode (versión preliminar): Especifica cómo se pueden anular las reservas de consultas en la región (por ejemplo, 'ALLOW_ANY_OVERRIDE'). Para obtener más detalles, consulta la lista de opciones de ALTER PROJECT SET OPTIONS.
  • disable_on_demand_billing (versión preliminar): Determina si la facturación a pedido está inhabilitada para las consultas en la región. Si es true, todas las búsquedas deben usar una reserva asignada o fallarán. Para obtener más detalles, consulta la lista de opciones de ALTER PROJECT SET OPTIONS.
  • preflight_fluid_autoscaling_reservations: Es la lista de reservas que se habilitaron para el escalamiento fluido para la facturación por segundo sin duración mínima. Para obtener más información, consulta Información sobre las reservas.

Precios

No se aplican cargos adicionales por usar el servicio de configuración de BigQuery. Si deseas obtener más información, consulta los Precios de BigQuery.