Administra la configuración

Los administradores de BigQuery y los propietarios de proyectos pueden administrar los parámetros de configuración a nivel de la organización y del proyecto. Puedes establecer configuraciones para aplicar la seguridad, controlar los costos y optimizar el rendimiento de las consultas en toda tu infraestructura de datos. Si configuras valores predeterminados, puedes garantizar el cumplimiento coherente y la eficiencia operativa, lo que facilita la administración de tu entorno de BigQuery.

En las siguientes secciones, se describe cómo especificar la configuración predeterminada. Los ajustes predeterminados se configuran a nivel de organización o de proyecto, pero se pueden anular a nivel de sesión o de trabajo.

Roles obligatorios

Para obtener el permiso que necesitas para especificar un parámetro de configuración, pídele a tu administrador que te otorgue el rol de IAM de administrador de BigQuery (roles/bigquery.admin). Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso bigquery.config.update, que se requiere para especificar un parámetro de configuración.

También puedes obtener este permiso 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.

Cómo especificar la configuración global

Puedes especificar la configuración global a nivel de la organización o del proyecto.

Limitaciones

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

La configuración global de la organización y del proyecto no está disponible en las ubicaciones de Omni de BigQuery.
Cuando modificas el parámetro de configuración global default_location, la propagación puede tardar hasta 10 minutos. Hasta que se propague el parámetro de configuración, es posible que las búsquedas aptas se enruten a la ubicación predeterminada anterior.

Configura los parámetros de configuración globales de la organización

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

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 no se especifica la ubicación 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.

Puedes configurar los parámetros globales a nivel de la organización con la declaración DDL ALTER ORGANIZATION SET OPTIONS. La ubicación predeterminada es el único parámetro de configuración de la organización global. La ubicación predeterminada se usa para ejecutar trabajos cuando no se puede inferir la ubicación a partir de la solicitud.

Cuando configuras la ubicación predeterminada, no especificas una región en la que se aplica el parámetro de configuración. No puedes combinar la configuración global y regional en la misma instrucción DDL.

Para configurar default_location a nivel de la organización, sigue estos pasos:

Console

Ve a la página de BigQuery en la consola de Google Cloud .

Ir a BigQuery
Haz clic en el editor de consultas. Esta pestaña se etiqueta como search_insights Consulta sin título.
Para configurar el default_location, ingresa la siguiente instrucción DDL en el Editor de consultas:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
Reemplaza LOCATION por una ubicación regional o multirregional. Este valor es la ubicación que se usa para ejecutar trabajos cuando no se puede inferir de la solicitud. Por ejemplo, la ubicación predeterminada se usa si no se puede determinar la ubicación de los conjuntos de datos en una consulta.
Como alternativa, para borrar la configuración global a nivel de la organización default_location, ingresa la siguiente instrucción DDL en el Editor de consultas:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );
```
Haz clic en Ejecutar.

bq

Para configurar default_location a nivel de la organización, ingresa el comando bq query y proporciona la siguiente instrucción DDL como parámetro de consulta. Establece la marca use_legacy_sql en false.
```
ALTER ORGANIZATION
SET OPTIONS (
`default_location` = 'LOCATION'
);
```
Reemplaza LOCATION por una ubicación regional o multirregional. Este valor es la ubicación que se usa para ejecutar trabajos cuando no se puede inferir de la solicitud. Por ejemplo, se usa la ubicación predeterminada si no se puede determinar la ubicación de los conjuntos de datos en una consulta.
Para borrar default_location a nivel de la organización, ingresa el comando bq query y proporciona la siguiente instrucción de DDL como parámetro de consulta. Establece la marca use_legacy_sql en false.
```
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.

Configura los parámetros de configuración globales del proyecto

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

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.

Puedes configurar los parámetros globales a nivel del proyecto con la declaración DDL ALTER PROJECT SET OPTIONS. La declaración DDL ALTER PROJECT SET OPTIONS acepta de forma opcional la variable PROJECT_ID. Si no se especifica PROJECT_ID, el valor predeterminado es el proyecto actual en el que ejecutas la sentencia ALTER PROJECT de DDL.

La ubicación predeterminada es el único parámetro de configuración global del proyecto. Cuando configuras la ubicación predeterminada, no especificas una región en la que se aplica el parámetro de configuración. No puedes combinar la configuración global y regional en la misma instrucción DDL.

Las configuraciones a nivel de proyecto anulan las configuraciones a nivel de organización. A su vez, las opciones de configuración a nivel de proyecto se pueden anular con las configuraciones a nivel de sesión, que se pueden anular con las configuraciones a nivel de trabajo

Para configurar default_location a nivel del proyecto, sigue estos pasos:

Console

Ve a la página de BigQuery en la consola de Google Cloud .

Ir a BigQuery
Haz clic en el editor de consultas. Esta pestaña se etiqueta como search_insights Consulta sin título.
Para configurar el 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: Es una ubicación regional o multirregional. Este valor es la ubicación que se usa para ejecutar trabajos cuando no se puede inferir de la solicitud. Por ejemplo, se usa la ubicación predeterminada si no se puede determinar la ubicación de los conjuntos de datos en una consulta.
También puedes ingresar la siguiente declaración de DDL en el Editor de consultas para borrar el parámetro de configuración de default_location. Si borras el default_location a nivel del proyecto, se usarán los parámetros de configuración predeterminados a nivel de la organización, si existen. De lo contrario, se usa el parámetro de configuración predeterminado del sistema.
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );
```
Haz clic en Ejecutar.

bq

Para configurar default_location a nivel del proyecto, ingresa el comando bq query y proporciona la siguiente instrucción DDL como parámetro de consulta. Establece la marca use_legacy_sql en false.
```
ALTER PROJECT PROJECT_ID
SET OPTIONS (
`default_location` = 'LOCATION'
);
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto.
- LOCATION: Es una ubicación regional o multirregional. Este valor es la ubicación que se usa para ejecutar trabajos cuando no se puede inferir de la solicitud. Por ejemplo, la ubicación predeterminada se usa si no se puede determinar la ubicación de los conjuntos de datos en una consulta.
Como alternativa, para borrar el default_location a nivel del proyecto, ingresa el comando bq query y proporciona la siguiente instrucción de DDL como parámetro de consulta. Establece la marca use_legacy_sql en false. Si borras el default_location a nivel del proyecto, se usarán los parámetros de configuración predeterminados a nivel de la organización, si existen. De lo contrario, se usa el parámetro de configuración predeterminado del sistema.
```
ALTER PROJECT PROJECT_ID
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.

Especifica la configuración regional

Puedes configurar los parámetros regionales a nivel de la organización o del proyecto.

Configura los parámetros regionales de la organización

Puedes configurar los parámetros regionales 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.

Para configurar los parámetros de configuración regionales de la organización, sigue estos pasos. En el siguiente ejemplo, se especifican varios parámetros de configuración regionales predeterminados, incluidos los siguientes:

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)
INFORMATION_SCHEMA: habilitada

Para ver todos los parámetros de configuración de la organización regional, ve a organization_set_options_list.

Console

Ve a la página de BigQuery en la consola de Google Cloud .

Ir a BigQuery
Haz clic en el editor de consultas. Esta pestaña se etiqueta como search_insights Consulta sin título.

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:

REGION: Es la región asociada con tu organización o proyecto, 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 borrar la configuración regional de la organización, ingresa la siguiente declaració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);

Haz clic en Ejecutar.

bq

Para configurar los parámetros de configuración regionales de la organización, ingresa el comando bq query y proporciona la siguiente instrucción DDL como parámetro de consulta. Establece la marca use_legacy_sql en false.

  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);

Reemplaza lo siguiente:

REGION: Es la región asociada con tu organización o proyecto, 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 borrar la configuración regional de la organización, ingresa el comando bq query y proporciona la siguiente declaración DDL como parámetro de consulta. Establece la marca use_legacy_sql en false:

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.default_storage_billing_model`= NULL,
  `region-REGION.default_max_time_travel_hours` = NULL,
  `region-REGION.default_cloud_resource_connection_id` = NULL,
  `region-REGION.default_sql_dialect_option` = NULL,
  `region-REGION.enable_reservation_based_fairness` = NULL,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL);

API

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

Configura los parámetros regionales del proyecto

Puedes configurar los parámetros regionales a nivel del proyecto con la declaración DDL ALTER PROJECT SET OPTIONS. Cuando especifiques la configuración, debes especificar la región en la que se aplica. Solo puedes usar una región en cada instrucción.

La declaración DDL ALTER PROJECT SET OPTIONS acepta de forma opcional la variable PROJECT_ID. Si no se especifica la variable PROJECT_ID, el valor predeterminado es el proyecto actual en el que ejecutas la sentencia DDL ALTER PROJECT.

En el siguiente ejemplo, se especifican varios parámetros de configuración regionales a nivel del proyecto, incluidos los siguientes:

Zona horaria: America/Los_Angeles
Clave de Cloud KMS: Una clave de ejemplo
Tiempo de espera de la consulta: 1 hora (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)
Equidad basada en reservas: Habilitada
Consultas globales: Habilitadas para ejecutar y acceder a los datos
INFORMATION_SCHEMA: habilitada

Para ver todos los parámetros de configuración regionales del proyecto, ve a project_set_options_list.

Console

Ve a la página de BigQuery en la consola de Google Cloud .

Ir a BigQuery
Haz clic en el editor de consultas. Esta pestaña se etiqueta como search_insights Consulta sin título.

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: Es la región asociada con tu organización o proyecto, 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 borrar la configuración del proyecto regional, ingresa la siguiente declaración 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_info_schema_storage` = NULL);

Haz clic en Ejecutar.

bq

Para configurar los parámetros regionales del proyecto, ingresa el comando bq query y proporciona la siguiente instrucción DDL como parámetro de consulta. Establece la marca use_legacy_sql en false.
```
ALTER PROJECT PROJECT_ID
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_reservation_based_fairness` = true);
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto.
- REGION: Es la región asociada con tu organización o proyecto, 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 borrar la configuración del proyecto regional, ingresa el comando bq query y proporciona la siguiente declaración DDL como parámetro de consulta. Establece la marca use_legacy_sql en false:

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_reservation_based_fairness` = false,
`region-REGION.enable_global_queries_execution` = NULL,
`region-REGION.enable_global_queries_data_access` = 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:

INFORMATION_SCHEMA.PROJECT_OPTIONS: las opciones de configuración aplicadas a un proyecto.
INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS: las configuraciones efectivas aplicadas a un proyecto. Las configuraciones efectivas incluyen todas las configuraciones establecidas a nivel de proyecto, así como todos los parámetros de configuración heredados por el proyecto desde una organización.
INFORMATION_SCHEMA.ORGANIZATION_OPTIONS: las opciones de configuración aplicadas a una organización.

Las nuevas configuraciones pueden tardar unos minutos en entrar en vigor y reflejarse en la vista INFORMATION_SCHEMA.

Roles obligatorios

Para obtener el permiso que necesitas para recuperar la configuración, pídele a tu administrador que te otorgue el rol de IAM de usuario de trabajos de BigQuery (roles/bigquery.jobUser) en el proyecto especificado. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso bigquery.config.get, que se requiere para recuperar la configuración.

También puedes obtener este permiso 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.

Ejemplos

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 de la ubicación predeterminada, 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 la configuración global efectiva de la ubicación predeterminada para tu proyecto predeterminado, ejecuta la siguiente consulta:

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

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

SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;

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

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

Cómo ver 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;

Parámetros de configuración

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: la cantidad de tiempo predeterminada, en milisegundos, que una consulta por lotes se pone en cola. 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: la cantidad de tiempo predeterminada, en milisegundos, que una consulta interactiva se pone en cola. Si no se configura, el valor predeterminado es seis horas. El valor mínimo es 1 milisegundo. 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 secuencias de comandos, debes usar el método de la API jobs.insert y establecer el campo jobTimeoutMs.

Nota: El parámetro de configuración default_query_job_timeout_ms también se aplica a los trabajos de consultas continuas. Para anular este parámetro de configuración a nivel del proyecto para una consulta continua individual, asigna un tiempo de espera del trabajo a la consulta continua en cuestión. Las consultas continuas siguen cumpliendo con los tiempos de ejecución máximos.
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 configura default_location, el trabajo se ejecuta en la multirregión US.
enable_reservation_based_fairness: Es la opción que determina cómo se comparten los espacios inactivos. El valor predeterminado es falso, lo que significa que las ranuras inactivas se distribuyen de manera equitativa entre todos los proyectos de consultas. Si está habilitado, las ranuras inactivas se comparten de forma equitativa entre todas las reservas primero y, luego, entre los proyectos dentro de la reserva. Para obtener más información, consulta Equidad basada en reservas. Esta opción solo se admite a nivel del proyecto. No puedes especificarlo a nivel de la organización o del trabajo.
default_time_zone: 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.

Nota: Si deseas establecer una zona horaria predeterminada, asegúrate de que las consultas existentes que usan literales DATETIME no se vean afectadas. Esto incluye consultas con la palabra clave DATETIME explícita, literales de cadena convertidos de forma implícita pasados como un parámetro a las funciones de tiempo, como DATETIME_DIFF('2022-10-01', ...), la función PARSE_DATETIME(), etcétera. Por este motivo, es más seguro configurar solo el parámetro default_time_zone en proyectos nuevos.
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' (valor predeterminado): Usa SQL heredado si no se especifica el dialecto de la consulta 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 no se especifica el dialecto de la consulta a nivel del trabajo. Rechaza los trabajos con el dialecto de consulta establecido en SQL heredado.
- NULL: Usa el parámetro de configuración predeterminado del dialecto de consulta, que es equivalente a 'default_legacy_sql'.
enable_global_queries_execution: Es la opción que determina si se pueden ejecutar 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 consultas 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.

Configuración de administración de datos

Usa los siguientes parámetros de configuración para definir reglas sobre la creación, la seguridad y el 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_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.

Nota: Para establecer una clave predeterminada de Cloud KMS, debes otorgar el rol de encriptador/desencriptador a todas las cuentas de servicio de BigQuery que se usen dentro del proyecto o la organización. Si una cuenta de servicio dentro del proyecto o la organización no tiene los permisos adecuados, fallarán todas las consultas que ejecute la cuenta de servicio. Para obtener información sobre cómo asignar el rol de encriptador/desencriptador, consulta Asigna el rol de encriptador/desencriptador. Si configuras una clave de Cloud KMS predeterminada sin asignar primero los roles adecuados, puedes borrar la clave predeterminada si configuras el valor como NULL. Para ver ejemplos, consulta Establece la configuración de la organización y Establece la configuración del proyecto.
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 la cantidad predeterminada de horas máximas de viaje 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 de 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 se proporcionarán instrucciones para habilitarla. Después de habilitar esta opción, las consultas se realizarán correctamente de inmediato y devolverán los datos generados a partir de ese momento. El 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. Ten en cuenta que 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 se creen tablas y modelos. Solo especifica el ID o el nombre de la conexión, y excluye los prefijos de región y de ID del proyecto adjuntos. El uso de conexiones predeterminadas puede provocar que se actualicen 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.

Precios

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