Referencia de la herramienta de línea de comandos

En este documento, se describen los comandos y marcas de la herramienta de línea de comandos bq. Para obtener información sobre el uso de la herramienta de línea de comandos de bq, consulta Usa la herramienta de línea de comandos de bq.

Marcas globales

Puedes usar las siguientes marcas globales con la herramienta de línea de comandos de bq.

Marcas de autorización de bq [OBSOLETAS]

Las marcas de autorización de bq se dieron de baja. Si deseas configurar la autorización para la herramienta de línea de comandos de bq, consulta la Autorización de las herramientas del SDK de Cloud

--application_default_credential_file
Si deseas obtener más información, consulta Configura la autenticación para aplicaciones de producción de servidor a servidor. El valor predeterminado es ''.
--credential_file
El nombre del archivo que se usa para almacenar tu token de OAuth. El valor predeterminado es $HOME/.bigquery.v2.token.
--service_account
Usa esta dirección de correo electrónico de cuenta de servicio para la autorización. Por ejemplo: 1234567890@developer.gserviceaccount.com. El valor predeterminado es ''.
--service_account_credential_file
El archivo que se usa como almacén de credenciales para cuentas de servicio. Esta marca se debe configurar si usas una cuenta de servicio.
--service_account_private_key_file
El archivo que contiene la clave privada de la cuenta de servicio. Esta marca es obligatoria si se especifica la marca --service_account. El valor predeterminado es ''.
--service_account_private_key_password
La contraseña de la clave privada. La contraseña debe coincidir con la que configuraste para la clave en el momento de su creación. El valor predeterminado es notasecret.
--use_gce_service_account
Especifica esta marca para usar credenciales de cuenta de servicio en lugar de credenciales almacenadas cuando ejecutas en una instancia de Compute Engine. Si deseas obtener más información, consulta Crea y habilita cuentas de servicio para instancias. El valor predeterminado es false.

Marcas globales de bq

--api
El extremo de API al que se llamará. El valor predeterminado es https://www.googleapis.com.

--api_version La versión de la API que se usará. El valor predeterminado es v2.

--apilog
Registra todas las solicitudes y respuestas a la API en el archivo que especifica esta marca. También puedes usar stdout y stderr. Si especificas la string vacía (''), se registra en stdout.
--bigqueryrc
Es la ruta de acceso al archivo de configuración de la herramienta de línea de comandos de bq. El archivo de configuración especifica nuevos valores predeterminados para todas las marcas. Esto se puede anular mediante la especificación de la marca en la línea de comandos. Si no se especifica la marca --bigqueryrc, se usa la variable de entorno BIGQUERYRC. Si no se especifica la variable, se usa la ruta de acceso ~/.bigqueryrc. El valor predeterminado es $HOME/.bigqueryrc.
--ca_certificates_file
La ubicación de tu archivo de Certificado de CA. El valor predeterminado es ''.
--dataset_id
El conjunto de datos predeterminado que se usa para las solicitudes. Esta marca se ignora cuando no es aplicable. Puedes establecer el valor en PROJECT:DATASET o DATASET. Si falta PROJECT, se usa el proyecto predeterminado. Puedes anular esta configuración si especificas la marca --project_id. El valor predeterminado es ''.
--debug_mode
Muestra objetos traceback en las excepciones de Python. El valor predeterminado es false.
--disable_ssl_validation
Inhabilita la validación del certificado HTTPS. El valor predeterminado es false.
--discovery_file
El nombre del archivo JSON que se debe leer para la detección. El valor predeterminado es ''.
--enable_gdrive
Cuando se configura en true, se solicita un token de OAuth nuevo con alcance de GDrive. Cuando se configura en false, se solicita un token de OAuth nuevo sin alcance de GDrive.
--fingerprint_job_id
Determina si se debe usar un ID de trabajo derivado de una huella digital de la configuración del trabajo. Esto evita que el mismo trabajo se ejecute varias veces por accidente. El valor predeterminado es false.
--flagfile
Cuando se especifica, las definiciones de marcas del archivo que se proporcionó se insertan en la herramienta de línea de comandos de bq. El valor predeterminado es ''.
--format

Especifica el formato del resultado del comando. Incluye las siguientes opciones:

  • pretty: genera una tabla con formato
  • sparse: genera una tabla más simple
  • prettyjson: formato JSON fácil de leer
  • json: JSON lo más compacto posible
  • csv: formato csv con encabezado

Las opciones pretty, sparse y prettyjson están diseñadas para que las pueda leer un ser humano. En cambio, las opciones json y csv están pensadas para pasarlas a otro programa. Si se especifica none, el comando no produce ningún resultado. Si la marca --format está ausente, se elige un formato de resultado apropiado según el comando.

--headless

Especifica si se debe ejecutar la sesión bq sin interacción del usuario. Cuando se establece en true, la interacción está inhabilitada. Por ejemplo, debug_mode no accederá al depurador, y la frecuencia de impresión de la información se disminuirá. El valor predeterminado es false.

--httplib2_debuglevel=DEBUG_LEVEL

Especifica si se debe mostrar la información de depuración HTTP. Si DEBUG_LEVEL es > 0, se registran las solicitudes del servidor HTTP y las respuestas a stderr, además de los mensajes de error. Si DEBUG_LEVEL no es > 0, o si no se usa la marca --httplib2_debuglevel, solo se proporcionan los mensajes de error.

Por ejemplo: --httplib2_debuglevel=1

--job_id
El ID de trabajo único que se usará para la solicitud. Si no se especifica en una solicitud de creación de trabajo, se genera un ID de trabajo. Esta marca solo se aplica a los comandos que crean trabajos: cp, extract, load y query. Para obtener más información, consulta Ejecuta trabajos de manera programática.
--job_property
Un par clave-valor para incluir en el campo de propiedades de la configuración del trabajo. Repite esta marca para especificar propiedades adicionales.
--location

Una string correspondiente a tu región o ubicación multirregión. La marca de ubicación es obligatoria para los comandos cancel y para los comandos show cuando usas la marca -j a fin de mostrar información sobre los trabajos. La marca de ubicación es opcional para los siguientes comandos:

Todos los demás comandos ignoran la marca --location.

--max_rows_per_request

Es un número entero que especifica la cantidad máxima de filas que se mostrarán por lectura.

--project_id

El ID del proyecto que se usará para las solicitudes. El valor predeterminado es ''.

--proxy_address

Es el nombre o la dirección IP del host del proxy que se usará para establecer la conexión a Google Cloud. El valor predeterminado es ''.

--proxy_password

La contraseña que se usará para la autenticación con el host del proxy. El valor predeterminado es ''.

--proxy_port

El número de puerto que se usará para la conexión al host del proxy. El valor predeterminado es ''.

--proxy_username

El nombre de usuario que se usará para la autenticación con el host del proxy. El valor predeterminado es ''.

--quiet o -q

Si se configura en true, ignora las actualizaciones de estado mientras los trabajos estén ejecutándose. El valor predeterminado es false.

--synchronous_mode o -sync

Si se configura en true, espera a que se complete el comando antes de mostrar el trabajo y usa el estado de finalización del trabajo como código de error. Si se configura como false, se crea el trabajo y se usa el estado de finalización correcto para el código de error. El valor predeterminado es true.

--trace

Un token de seguimiento especificado como token:TOKEN para incluir en las solicitudes a la API.

Marcas específicas de comandos

Puedes usar las siguientes marcas de comando en la herramienta de línea de comandos bq.

bq add-iam-policy-binding

El comando add-iam-policy-binding recupera la política de administración de identidades y accesos (IAM) para un recurso (tabla o vista) y agrega una vinculación a la política, todo en un paso.

Este comando es una alternativa al siguiente proceso de tres pasos:

  1. Usa el comando get-iam-policy para recuperar el archivo de políticas (en formato JSON)
  2. Edita el archivo de políticas
  3. Usa el comando set-iam-policy para actualizar la política con una vinculación nueva.

Uso: 

bq add-iam-policy-binding --member="MEMBER" --role="ROLE" [-COMMAND_FLAGS] RESOURCE_IDENTIFIER

El comando add-iam-policy-binding usa los siguientes argumentos y marcas específicos de él.

--member
La parte miembro de la vinculación de la política de IAM. La marca --member es obligatoria junto con la marca --role. Una combinación de --member y --role equivale a una vinculación. Consulta la referencia de la Política de IAM para obtener detalles sobre las vinculaciones.
--role
La parte de la función que pertenece a la vinculación de política de IAM. La marca --role es obligatoria, con la marca --member. Una combinación de las marcas --member y --role equivale a una vinculación. Consulta la referencia de la Política de IAM para obtener detalles sobre las vinculaciones.
-t --table/view
Cuando se especifica, agrega una vinculación a la política de IAM de una tabla o vista. Opcional. El valor predeterminado es false.

RESOURCE_IDENTIFIER es el recurso (tabla o vista) cuya política se está actualizando.

bq cancel

El comando cancel se usa para cancelar trabajos. No hay marcas específicas para el comando cancel.

Para obtener más información sobre el uso del comando cancel, consulta Administra trabajos.

El comando cancel usa las siguientes marcas globales.

--job_id
El ID de trabajo único que se usará para la solicitud. Puedes especificar el ID de trabajo único si usas la marca --job_id, por ejemplo: bq cancel JOB_ID.
--synchronous_mode o --sync
Cuando se especifica, espera a que el comando se complete antes de mostrar un resultado. Si se establece en false, el comando muestra un resultado de inmediato. El valor predeterminado es true.

bq cp

El comando cp se usa para copiar tablas. El comando cp usa las siguientes marcas específicas del comando.

Para obtener más información sobre el uso del comando cp, consulta Administra tablas.

--append_table o -a
Cuando se especifica, copia una tabla y la agrega a otra existente. El valor predeterminado es false.
--destination_kms_key
La clave de Cloud KMS que se usa para encriptar los datos de la tabla de destino.
--force o -f
Cuando se especifica, si la tabla de destino existe, la reemplaza sin ningún aviso. El valor predeterminado es false.
--no_clobber o -n
Cuando se especifica, si la tabla de destino existe, no la reemplaza. El valor predeterminado es false.

bq extract

El comando extract se usa para exportar datos de la tabla a Cloud Storage.

Para obtener más información sobre el uso del comando extract, consulta Exporta datos de tablas.

Uso: 

bq extract [-COMMAND_FLAGS] 'RESOURCE_IDENTIFIER' DESTINATION

El comando extract usa las siguientes marcas específicas del comando:

--compression
El tipo de compresión que se usará para los archivos exportados. En los valores posibles, se incluye GZIP (solo CSV y JSON), DEFLATE (solo Avro), SNAPPY (solo Avro) y NONE. El valor predeterminado es NONE.
--destination_format

El formato de los datos exportados. Entre los valores posibles, se incluyen los siguientes:

  • CSV
  • NEWLINE_DELIMITED_JSON
  • AVRO

El valor predeterminado es CSV.

--field_delimiter o -F

El carácter que indica el límite entre las columnas del archivo de salida para las exportaciones en formato CSV. \t y tab pueden ser delimitadores de tabulación.

--print_header o --noprint_header

A fin de eliminar las filas del encabezado de impresión para los formatos que tienen encabezados, especifica --noprint_header. Si se especifica --print_header o no se usa ninguna marca, se incluyen las filas de encabezado.

Ejemplo:

bq extract --compression GZIP --destination_format CSV --field_delimiter tab
    --noprintheader 'myDataset.myTable' gs://my-bucket/myFile.csv.gzip

bq get-iam-policy

Con el comando get-iam-policy, se recupera la política de IAM para un recurso (tabla o vista) y la imprime en stdout. La política está en formato JSON.

Para obtener más información sobre el comando get-iam-policy, con ejemplos, consulta Introducción a los controles de acceso a tablas.

Uso:

bq get-iam-policy [-COMMAND_FLAG] RESOURCE_IDENTIFIER

El comando get-iam-policy usa la siguiente marca específica del comando.

-t --table/view

Cuando se especifica, obtiene la política de IAM de una tabla o vista. Opcional. El valor predeterminado es false.

RESOURCE_IDENTIFIER es el recurso (tabla o vista) cuya política se está actualizando.

bq head

El comando head muestra las filas en una tabla.

Para obtener más información sobre el uso del comando head, consulta Cómo administrar datos de tablas

El comando head usa las siguientes marcas específicas del comando.

--job o -j
Especifica esta marca con un ID de trabajo válido para leer los resultados de un trabajo de consulta. El valor predeterminado es false.
--max_rows o -n
Un número entero que indica la cantidad de filas que se imprimirán cuando se muestren los datos de la tabla. El valor predeterminado es 100.
--selected_fields o -c
Una lista separada por comas que indica un subconjunto de campos (incluidos los campos anidados y repetidos) que deben incluirse cuando se muestren los datos de la tabla. Si no se especifica, se recuperan todas las columnas.
--start_row o -s
Un número entero que indica la cantidad de filas que se omitirán antes de mostrar datos de la tabla. El valor predeterminado es 0 (comienza en la primera fila).
--table o -t
Especifica esta marca con un ID de tabla para leer las filas de una tabla. El valor predeterminado es false.

bq insert

El comando insert te permite insertar filas de datos con formato JSON delimitado por saltos de línea mediante el búfer de transmisión. Los tipos de datos se convierten para que coincidan con los tipos de columna de la tabla de destino. Este comando debe usarse solo para hacer pruebas. Si quieres transmitir datos a BigQuery, usa el método de API insertAll.

Para obtener más información, consulta Transmite datos a BigQuery.

Uso: 

bq insert [COMMAND_FLAGS] TABLE FILE

El comando insert usa las siguientes marcas específicas del comando.

--ignore_unknown_values o -i
Cuando se especifica, ignora cualquier par clave-valor que no coincida con el esquema de la tabla y, luego, inserta la fila con los datos que no coinciden con el esquema. Si no se especifica la marca, no se insertarán las filas con datos que no coinciden con el esquema de la tabla.
--skip_invalid_rows o -s
Cuando se especifica, intenta insertar todas las filas válidas, incluso si hay filas que no lo son. Si no se especifica la marca, el comando falla si hay filas no válidas.
--template_suffix o -x
Cuando se especifica, trata a la tabla de destino como una plantilla base y, también, inserta las filas en una tabla de instancias llamada {destination}{templateSuffix}. BigQuery crea la tabla de instancias con el esquema de la plantilla base.

Ejemplos:

bq insert --ignore_unknown_values myDataset.myTable /tmp/myData.json

echo '{"a":1, "b":2}' | bq insert myDataset.myTable

bq load

El comando load carga datos en una tabla.

Para obtener más información sobre cómo cargar datos de Cloud Storage mediante el comando load, consulta los siguientes vínculos:

Para obtener más información sobre cómo cargar datos desde una fuente local con el comando load, consulta Carga datos de archivos locales.

El comando load usa las siguientes marcas específicas del comando.

--allow_jagged_rows
Cuando se especifica, permite que falten columnas opcionales finales en los datos de formato CSV.
--allow_quoted_newlines
Cuando se especifica, permite saltos de línea en secciones entrecomilladas en los datos de formato CSV.
--autodetect
Cuando se especifica, habilita la detección automática del esquema en los datos de formato CSV y JSON.
--clustering_fields
Es una lista separada por comas de hasta cuatro nombres de columnas.
--destination_kms_key
Es la clave de Cloud KMS para la encriptación de los datos de la tabla de destino.
--encoding o -E
La codificación de caracteres que se usa en los datos. Entre los valores posibles, se incluyen los siguientes:
  • ISO-8859-1 (también conocido como Latin-1)
  • UTF-8
--field_delimiter o -F
El carácter que indica el límite entre columnas en los datos. \t y tab pueden ser delimitadores de tabulación.
--ignore_unknown_values
Cuando se especifica, en el caso de los archivos CSV y JSON, las filas con valores de columna adicionales que no coinciden con el esquema de la tabla se ignoran y no se cargan. De manera similar, para los archivos Avro, Parquet y ORC, los campos del esquema de archivos que no existen en el esquema de la tabla se ignoran y no se cargan.
--max_bad_records
Un número entero que especifica la cantidad máxima de registros incorrectos permitidos antes de que falle todo el trabajo. El valor predeterminado es 0. Como máximo, se muestran cinco errores de cualquier tipo, sin importar el valor --max_bad_records.
--null_marker
Una string personalizada opcional que representa un valor NULL en los datos de formato CSV.
--projection_fields
Si se usa --source_format configurado en DATASTORE_BACKUP, indica qué propiedades de la entidad se deben cargar a partir de una exportación de Datastore como una lista separada por comas. Los nombres de las propiedades distinguen entre mayúsculas y minúsculas, y deben referirse a propiedades de nivel superior. El valor predeterminado es ''. Esta marca también se puede usar con las exportaciones de Firestore.
--quote CHARACTER
Para especificar un carácter de comillas en los campos, incluye esta marca. El argumento CHARACTER puede ser cualquier carácter de un solo byte. El valor predeterminado es " (comillas dobles). Para especificar que no hay ningún carácter de comilla, usa una string vacía ("").
--replace
Cuando se especifica, todos los datos y esquemas existentes se borran cuando se cargan datos nuevos. También se quita cualquier clave de Cloud KMS, a menos que especifiques la marca --destination_kms_key. El valor predeterminado es false. Puedes usar la declaración TRUNCATE TABLE para quitar todas las filas de una tabla sin borrar el esquema.
--schema
Es la ruta de acceso a un archivo de esquema JSON local o una lista de definiciones de columnas separadas por comas con el formato FIELD:DATA_TYPE,FIELD:DATA_TYPE. Si usas un archivo de esquema, no le pongas una extensión.
--schema_update_option

Cuando se agregan datos a una tabla (en un trabajo de carga o de consulta) o se reemplaza una partición de una tabla, especifica cómo actualizar el esquema de la tabla de destino. Estos son algunos de los valores posibles:

  • ALLOW_FIELD_ADDITION: Permite que se agreguen campos nuevos.
  • ALLOW_FIELD_RELAXATION: Permite disminuir la rigurosidad de los campos REQUIRED a NULLABLE.

Repite esta marca para especificar varias opciones de actualización del esquema.

--skip_leading_rows

Un número entero que especifica la cantidad de filas que se deben omitir al principio del archivo de origen.

--source_format

El formato de los datos de origen. Estos son algunos de los valores posibles:

  • CSV
  • NEWLINE_DELIMITED_JSON
  • AVRO
  • DATASTORE_BACKUP
  • PARQUET
  • ORC
--time_partitioning_expiration

Un número entero que especifica (en segundos) cuándo se debe borrar una partición basada en el tiempo. La fecha y hora de vencimiento se evalúa según la suma de la fecha de la partición en formato UTC más el valor del número entero. Si el número es negativo, no hay vencimiento.

--time_partitioning_field

El campo utilizado para determinar cómo crear una partición basada en el tiempo. Si la partición basada en el tiempo se habilita sin este valor, la tabla se particiona en función del tiempo de carga.

--time_partitioning_type

Habilita las particiones basadas en el tiempo en una tabla y establece el tipo de partición. Los valores posibles son DAY, HOUR, MONTH o YEAR. El tipo de partición predeterminado para la partición basada en el tiempo es DAY.

--use_avro_logical_types

Si sourceFormat se configura como AVRO, indica si se deben convertir tipos lógicos en sus tipos correspondientes (como TIMESTAMP) en lugar de solo usar sus tipos sin procesar (como INTEGER).

--decimal_target_types

: Determina cómo convertir un tipo lógico Decimal. Equivale a JobConfigurationLoad.decimalTargetTypes. Repite esta marca para especificar varios tipos de destino.

bq ls

El comando ls enumera los objetos en una colección.

Para obtener más información sobre el uso del comando ls, consulta:

El comando ls usa las siguientes marcas específicas del comando.

--all o -a
Cuando se especifica, muestra todos los resultados: trabajos de todos los usuarios o todos los conjuntos de datos (incluidos los ocultos). Esta marca no es necesaria cuando se enumeran los tipos de configuración de transferencia o ejecuciones de transferencia.
--capacity_commitment
Cuando se especifica, enumera los compromisos de capacidad. El valor predeterminado es false.
--datasets o -d
Cuando se especifica, muestra una lista de conjuntos de datos. El valor predeterminado es false.
--filter "FILTER"

Muestra los conjuntos de datos que coinciden con FILTER, que consta de uno o más triples separados por espacios en el formato labels.KEY:VALUE. Si se proporciona más de un triple, solo muestra los conjuntos de datos que coinciden con todos los triples (es decir, usa el operador AND, no OR).

--jobs o -j

Cuando se especifica, muestra una lista de trabajos. El valor predeterminado es false. De forma predeterminada, tienes un límite de 100,000 resultados.

--max_creation_time

Un número entero que representa una marca de tiempo en milisegundos. Cuando se especifica con la marca -j, muestra una lista de los trabajos creados antes de la marca de tiempo.

--max_results o -n

Un número entero que indica la cantidad máxima de resultados. El valor predeterminado es 50.

--min_creation_time

Un número entero que representa una marca de tiempo en milisegundos. Cuando se especifica con la marca -j, esta marca enumera los trabajos creados después de la marca de tiempo.

--message_type

Para mostrar una lista de mensajes de registro de ejecución de transferencia pertenecientes a un tipo determinado, especifica messageTypes:MESSAGE_TYPE. Entre los valores posibles, se incluyen los siguientes:

  • INFO
  • WARNING
  • ERROR
--models o -m

Cuando se especifica, muestra los modelos de BigQuery ML.

--page_token o -k

Cuando se especifica, muestra una lista de los elementos a partir de este token de página.

--projects o -p

Cuando se especifica, muestra todos los proyectos. El valor predeterminado es false.

--reservation

Cuando se especifica, enumera todas las reservas de un proyecto y una ubicación determinados. El valor predeterminado es false.

--reservation_assignment

Cuando se especifica, enumera todas las asignaciones de reserva de una ubicación y un proyecto determinados. El valor predeterminado es false.

--run_attempt

Configura esta marca en LATEST enumerar solo las ejecuciones más recientes de una transferencia.

--transfer_config

Cuando se especifica, muestra una lista de configuraciones de transferencia. Cuando uses esta marca, también debes especificar --transfer_location. El valor predeterminado es false.

--transfer_location

Muestra una lista de las configuraciones de transferencia en la ubicación especificada. Debes establecer la ubicación de transferencia cuando se crea la transferencia.

--transfer_log

Cuando se especifica, muestra una lista de los mensajes de registro de transferencia de la ejecución de transferencias especificada. El valor predeterminado es false.

--transfer_run

Cuando se especifica, muestra una lista de ejecuciones de transferencias. El valor predeterminado es false.

bq mk

El comando mk crea varios recursos de BigQuery, incluidos conjuntos de datos, tablas, vistas, vistas materializadas y configuraciones de transferencia.

El comando mk toma una marca de tipo que especifica el tipo de recurso que deseas crear y otras marcas que dependen del tipo de recurso.

bq mk TYPE_FLAG [ OTHER FLAGS ] [ ARGS ]

En el ejemplo anterior, TYPE_FLAG es uno de los siguientes:

Además de las marcas específicas de comandos que se enumeran a continuación, bq mk admite la siguiente marca:

--force o -f
Ignora los errores si ya existe un recurso con el mismo nombre. Cuando se especifica, si el recurso ya existe, el código del resultado es 0. Esta marca no hace que el comando mk reemplace el recurso. El valor predeterminado es false.

bq mk --capacity_commitment

Compra un compromiso de capacidad. Para obtener más información, consulta Trabaja con compromisos. Se admiten las siguientes marcas:

--location
Es la ubicación del proyecto.
--plan
Es el tipo de plan (FLEX, MONTHLY o ANNUAL).
--project_id
El ID del proyecto que administra las ranuras.
--slots
Es la cantidad de ranuras que se deben comprar.

bq mk --dataset

Crea un conjunto de datos. Para obtener más información, consulta Crea conjuntos de datos. Se admiten las siguientes marcas:

--data_location
Esta es una marca heredada que especifica la ubicación del conjunto de datos. Usa la marca global --location en su lugar.
--default_kms_key
Especifica la clave de Cloud KMS para encriptar los datos de la tabla en un conjunto de datos si no se proporciona una clave explícita durante la creación o la consulta de la tabla.
--default_partition_expiration
Un número entero que especifica el vencimiento predeterminado (en segundos) de todas las particiones de las tablas particionadas nuevas que se crean en el conjunto de datos. La fecha y hora de vencimiento de una partición se determina según la suma de la fecha de la partición en formato UTC más el valor del número entero. Cuando se configura esta propiedad, se anula el vencimiento predeterminado de la tabla definido para todo el conjunto de datos, si existe. Si proporcionas la marca --time_partitioning_expiration cuando creas o actualizas una tabla particionada, el vencimiento de la partición a nivel de la tabla tiene prioridad sobre el vencimiento predeterminado de la partición definido para todo el conjunto de datos.
--default_table_expiration
Es un número entero que especifica la duración predeterminada (en segundos) de las tablas nuevas que se crean en un conjunto de datos. La fecha y hora de vencimiento se determina mediante la suma de la hora actual en formato UTC más este valor.
--description
Es la descripción del conjunto de datos.
--label
Es una etiqueta para el conjunto de datos. El formato es KEY:VALUE. Repite esta marca para especificar varias etiquetas.

bq mk --materialized_view

Crea una vista materializada. Se admiten las siguientes marcas:

--enable_refresh
Indica si la actualización automática está habilitada para una vista materializada. El valor predeterminado cuando se crea una vista materializada es true.
--refresh_interval_ms
Es el tiempo (en milisegundos) del intervalo de actualización de una vista materializada. Si no se especifica, el intervalo de actualización para una vista materializada que tiene habilitada la actualización es de 1,800,000 milisegundos, es decir, 30 minutos.

Para obtener más información, consulta Crea y usa vistas materializadas.

bq mk --reservation

Crea una reserva con ranuras dedicadas. Para obtener más información, consulta Trabaja con reservas. Se admiten las siguientes marcas:

--ignore_idle_slots
Si es true, los trabajos que se ejecutan en esta reserva solo usarán ranuras asignadas a ella. Si es false, los trabajos de esta reserva pueden usar ranuras inactivas de otras reservas o ranuras que no estén asignadas a una reserva. El valor predeterminado es false. Para obtener más información, consulta Ranuras inactivas.
--location
Es la ubicación del proyecto.
--project_id
Es el ID del proyecto al que pertenece la reserva.
--slots
Es la cantidad de ranuras que se asignarán a esta reserva.

bq mk --reservation_assignment

Asigna un proyecto, una carpeta o una organización a una reserva. Para obtener más información, consulta Trabaja con asignaciones. Se admiten las siguientes marcas:

--assignee_id
Es el ID de la carpeta, la organización o el proyecto.
--assignee_type
Es el tipo de entidad que se asignará a la reserva. Puede ser FOLDER, ORGANIZATION o PROJECT.
--job_type
Es el tipo de trabajo que se asignará a la reserva. Puede ser QUERY, PIPELINE o ML_EXTERNAL.
--location
Es la ubicación del proyecto.
--project_id
Es el ID del proyecto al que pertenece la reserva.
reservation_id
Es el ID de la reserva.

bq mk --table

Crea una tabla. Para obtener más información, consulta Crea y usa tablas. Se admiten las siguientes marcas:

--clustering_fields
Es una lista separada por comas de los nombres de columnas usados para agrupar una tabla en clústeres. Cuando se especifica, la tabla se agrupa en clústeres mediante las columnas proporcionadas. Si se especifica con la partición, la tabla se particiona y, luego, cada partición se agrupa en clústeres mediante las columnas proporcionadas.
--description
Es la descripción de la tabla.
--destination_kms_key
Es la clave de Cloud KMS que se usa para encriptar los datos de la tabla.
--expiration SECONDS
Especifica la vida útil de la tabla. Si SECONDS es 0, la tabla no expira. Si no incluyes la marca --expiration, BigQuery crea la tabla con el tiempo de vida predeterminado de la tabla del conjunto de datos.
--external_table_definition
Especifica una definición de tabla que se usará para crear una tabla externa. El valor puede ser una definición de tabla intercalada o una ruta de acceso a un archivo que contiene una definición de tabla en formato JSON. El formato de una definición intercalada es schema@format=uri.
--label
Es una etiqueta que se debe configurar en la tabla. El formato es KEY:VALUE. Repite esta marca para especificar varias etiquetas.
--range_partitioning

Especifica las opciones para una partición de rango de números enteros, como una lista separada por comas en el formato column_name,start,end,interval, en el que

  • column_name es la columna que se usó para crear las particiones por rango de números enteros.
  • start es el inicio de la partición por rango (inclusivo).
  • end es el final de la partición por rango (exclusivo).
  • interval es el ancho de cada rango dentro de la partición.
--require_partition_filter

Cuando se especifica, esta marca determina si se requiere un filtro de partición para las consultas sobre la tabla proporcionada. Esta marca solo se aplica a las tablas particionadas. El valor predeterminado es false.

--schema

La ruta de acceso a un archivo de esquema JSON local o una lista de definiciones de columnas separadas por comas con el formato FIELD:DATA_TYPE, FIELD:DATA_TYPE. El valor predeterminado es ''.

--time_partitioning_expiration

Un número entero que especifica (en segundos) cuándo se debe borrar una partición basada en el tiempo. La fecha y hora de vencimiento se evalúa según la suma de la fecha de la partición en formato UTC más el valor del número entero. Si el número es negativo, no hay vencimiento.

--time_partitioning_field

El campo utilizado para determinar cómo crear una partición basada en el tiempo. Si la partición basada en el tiempo se habilita sin este valor, la tabla se particiona en función del tiempo de carga.

--time_partitioning_type

Habilita las particiones basadas en el tiempo en una tabla y establece el tipo de partición. Los valores posibles son DAY, HOUR, MONTH o YEAR.

bq mk --transfer_config

Crea una configuración de transferencia. Se admiten las siguientes marcas:

--data_source Especifica la fuente de datos. Obligatorio cuando se crea una configuración de transferencia. Estos son algunos de los valores posibles:

--display_name
Es el nombre visible de la configuración de transferencia. El valor predeterminado es ''.
--params o -p
Son los parámetros de la configuración de la transferencia en formato JSON: {"PARAMETER":"VALUE"}. Los parámetros varían según la fuente de datos. Para obtener más información, consulta Introducción al Servicio de transferencia de datos de BigQuery.
--refresh_window_days
Es un número entero que especifica el período de actualización en días para la configuración de la transferencia. El valor predeterminado es 0.
--target_dataset
Es el conjunto de datos de destino para la configuración de transferencia. El valor predeterminado es ''.

Para obtener más información sobre el uso del comando de mk con el Servicio de transferencia de datos de BigQuery, consulta los siguientes vínculos:

bq mk --transfer_run

Crea una ejecución de transferencia de datos en el intervalo de tiempo o de tiempo especificado mediante la configuración de transferencia de datos especificada.

Uso: 

bq mk --transfer_run [--run_time RUN_TIME | --start_time START_TIME --end_time END_TIME] CONFIG

Se admiten las siguientes marcas:

--run_time
Una marca de tiempo que especifica la hora para programar la ejecución de la transferencia de datos.
--start_time
Es una marca de tiempo que especifica la hora de inicio para un rango de ejecuciones de transferencias.
--end_time
Una marca de tiempo que especifica la hora de finalización de un rango de ejecuciones de transferencias.

El formato de la marca de tiempo es RFC3339 UTC “Zulú”.

El argumento CONFIG especifica una configuración de transferencia de datos preexistente.

Ejemplos:

bq mk --transfer_run \
      --run_time 2021-01-20T17:00:00.00Z \
      projects/p/locations/l/transferConfigs/c

bq mk --transfer_run \
      --start_time 2020-12-19T16:39:57-08:00 \
      --end_time 2020-12-19T20:39:57-08:00 \
      projects/p/locations/l/transferConfigs/c

bq mk --view

Crea una vista. Para obtener más información, consulta Crea vistas. Se admiten las siguientes marcas:

--description
Es la descripción de la vista.
--expiration SECONDS
Especifica la vida útil de la vista. Si SECONDS es 0, la vista no vence. Si no incluyes la marca --expiration, BigQuery crea la vista con el ciclo de vida predeterminado de la tabla del conjunto de datos.
--label
Es una etiqueta que se debe establecer en la vista. El formato es KEY:VALUE. Repite esta marca para especificar varias etiquetas.
--use_legacy_sql
Cuando se establece en false, usa una consulta de SQL estándar para crear una vista. El valor predeterminado es true (usa SQL heredado).
--view_udf_resource
Es el URI de Cloud Storage o la ruta de acceso a un archivo de código local que se cargará y evaluará de inmediato como un recurso de función definida por el usuario usado por una consulta de SQL de la vista. Repite esta marca para especificar varios archivos.

bq mkdef

El comando mkdef crea una definición de tabla en formato JSON para los datos almacenados en Cloud Storage o Drive.

Para obtener más información sobre el uso del comando mkdef, consulta Cómo crear un archivo de definición de tablas para una fuente de datos externa.

El comando mkdef usa las siguientes marcas específicas del comando.

--autodetect
Cuando se especifica, usa la detección automática del esquema para datos CSV y JSON.
--ignore_unknown_values o -i
Cuando se especifica, ignora cualquier valor en una fila que no esté presente en el esquema.
--source_format

El formato de los datos de origen. Estos son algunos de los valores posibles:

  • AVRO
  • CSV
  • DATASTORE_BACKUP
  • GOOGLE_SHEETS
  • NEWLINE_DELIMITED_JSON
  • ORC
  • PARQUET

El valor predeterminado es CSV.

bq partition

El comando partition se usa para convertir tablas particionadas por sufijo de tiempo (como tablas que terminan en YYYYMMDD en la partición por fecha) en tablas particionadas.

Para obtener más información sobre el uso del comando partition, consulta la sección sobre cómo convertir tablas fragmentadas en fechas en tablas particionadas de tiempo de transferencia.

El comando partition usa las siguientes marcas específicas del comando.

--no_clobber o -n
Cuando se especifica, no se reemplaza una partición existente. El valor predeterminado es false.
--time_partitioning_expiration
Un número entero que especifica (en segundos) cuándo se debe borrar una partición basada en el tiempo. La fecha y hora de vencimiento se evalúa según la suma de la fecha de la partición en formato UTC más el valor del número entero. Si el número es negativo, no hay vencimiento.
--time_partitioning_type
Especifica el tipo de partición. Los valores posibles son DAY, HOUR, MONTH o YEAR. El formato esperado del bloque de unidades de tiempo es YYYYMMDD para DAY, YYYYMMDDHH para HOUR, YYYYMM para MONTH y YYYY Para YEAR.

bq query

El comando query crea un trabajo de consulta que ejecuta la consulta de SQL proporcionada.

Para obtener más información sobre el uso del comando query, consulta Cómo ejecutar trabajos de consulta interactivos y por lotes.

El comando query usa las siguientes marcas específicas del comando.

--allow_large_results
Cuando se especifica, habilita tablas de destino de gran tamaño para las consultas de SQL heredado.
--append_table
Cuando se especifica, agrega datos a una tabla de destino. El valor predeterminado es false.
--batch
Cuando se especifica, se ejecuta la consulta en modo por lotes. El valor predeterminado es false.
--clustering_fields
Si se especifica, se usa una lista de columnas separadas por comas para agrupar en clústeres la tabla de destino en una consulta. Cuando se especifica, la tabla se agrupa en clústeres mediante las columnas proporcionadas. Si se especifica con la partición, la tabla se particiona y, luego, cada partición se agrupa en clústeres mediante las columnas proporcionadas.
--destination_kms_key
La clave de Cloud KMS usada para encriptar los datos de la tabla de destino.
--destination_schema
La ruta de acceso a un archivo de esquema JSON local o una lista de definiciones de columnas separadas por comas con el formato FIELD:DATA_TYPE,FIELD:DATA_TYPE. El valor predeterminado es ''.
--destination_table TABLE

Cuando se especifica, los resultados de la consulta se guardan en TABLE. Especifica TABLE con el siguiente formato: PROJECT:DATASET.TABLE. Si no se especifica PROJECT, entonces se asume el proyecto actual. Si no se especifica la marca --destination_table, los resultados de la consulta se guardan en una tabla temporal.

Ejemplos:

  • --destination_table myProject:myDataset.myTable
  • --destination_table myDataset.myTable
--dry_run

Cuando se especifica, la consulta se valida, pero no se ejecuta.

--external_table_definition

El nombre de la tabla y la definición de esquema utilizados en una consulta de tabla externa. El esquema puede ser una ruta de acceso a un archivo de esquema JSON local o una lista de definiciones de columnas separadas por comas con el formato FIELD:DATA_TYPE,FIELD:DATA_TYPE. El formato para proporcionar el nombre y el esquema de la tabla es: TABLE::PATH_TO_FILE o TABLE::SCHEMA@SOURCE_FORMAT=CLOUD_STORAGE_URI. Repite esta marca para consultar varias tablas.

--flatten_results

Cuando se especifica, se compactan los campos anidados y repetidos en los resultados para las consultas de SQL heredado. El valor predeterminado es true.

--label

Una etiqueta para aplicar a un trabajo de consulta con el formato KEY:VALUE. Repite esta marca para especificar varias etiquetas.

--max_rows o -n

Un número entero que especifica la cantidad de filas que se deben mostrar en los resultados de la consulta. El valor predeterminado es 100.

--maximum_bytes_billed

Un número entero que limita los bytes facturados para la consulta. Si la consulta supera el límite, falla (sin incurrir en cargos). Si no se especifica, los bytes facturados se configuran en el valor predeterminado del proyecto.

--min_completion_ratio

[Experimental] Un número entre 0 y 1.0 que especifica la fracción mínima de datos que deben analizarse antes de que se muestre el resultado de una consulta. Si no se establece, se usa 1.0, el valor predeterminado del servidor.

--parameter

Un archivo JSON que contiene una lista de parámetros de búsqueda o un parámetro de búsqueda con el formato NAME:TYPE:VALUE. Si el nombre está vacío, se crea un parámetro posicional. Se puede omitir TYPEpara asumir un valor STRING con el formato NAME::VALUE o ::VALUE. NULL genera un valor nulo. Repite esta marca para especificar varios parámetros.

--replace

Si se especifica, reemplaza la tabla de destino con los resultados de la consulta. Se borrarán los datos y el esquema existentes. También se quita cualquier clave de Cloud KMS, a menos que especifiques la marca --destination_kms_key. El valor predeterminado es false. Para quitar todas las filas de una tabla sin borrar el esquema, usa la declaración TRUNCATE TABLE.

--require_cache

Cuando se especifica, ejecuta la consulta solo si los resultados se pueden recuperar a partir de la caché.

--require_partition_filter

Si se especifica, se requiere un filtro de partición para las consultas sobre la tabla suministrada. Esta marca solo se puede usar con una tabla particionada.

--rpc

Si se especifica, usa la API de consulta de estilo rpc en lugar del método jobs.insert de la API de REST. El valor predeterminado es false.

--schedule

Convierte una consulta en una consulta programada recurrente. Es necesario tener un programa con la frecuencia con la que se debe ejecutar la consulta. Ejemplos:

  • --schedule='every 24 hours'
  • --schedule='every 3 hours'
--schema_update_option

Cuando se agregan datos a una tabla (en un trabajo de carga o de consulta) o se reemplaza una partición de una tabla, especifica cómo actualizar el esquema de la tabla de destino. Estos son algunos de los valores posibles:

  • ALLOW_FIELD_ADDITION: Permite que se agreguen campos nuevos.
  • ALLOW_FIELD_RELAXATION: Permite disminuir la rigurosidad de los campos REQUIRED a NULLABLE.

Repite esta marca para especificar varias opciones de actualización del esquema.

--start_row o -s

Un número entero que especifica la primera fila que se mostrará en el resultado de la consulta. El valor predeterminado es 0.

--target_dataset

Cuando se especifica con --schedule, actualiza el conjunto de datos de destino para una consulta programada. La consulta debe ser DDL o DML.

--time_partitioning_expiration

Un número entero que especifica (en segundos) cuándo se debe borrar una partición basada en el tiempo. La fecha y hora de vencimiento se evalúa según la suma de la fecha de la partición en formato UTC más el valor del número entero. Si el número es negativo, no hay vencimiento.

--time_partitioning_field

El campo utilizado para determinar cómo crear una partición basada en el tiempo. Si la partición basada en el tiempo se habilita sin este valor, la tabla se particiona en función del tiempo de carga.

--time_partitioning_type

Cuando se usa con la marca destination_table, especifica el tipo de partición para la tabla de destino. Los valores posibles son DAY, HOUR, MONTH o YEAR.

--udf_resource

Esta marca solo se aplica a las consultas de SQL heredado. Especifica el URI de Cloud Storage o la ruta de acceso a un archivo local que contiene un recurso de función definido por el usuario que se usará en una búsqueda de SQL heredado. Repite esta marca para especificar varios archivos.

--use_cache

Cuando se especifica, almacena en caché los resultados de la consulta. El valor predeterminado es true.

--use_legacy_sql

Cuando se establece en false, ejecuta una consulta de SQL estándar. El valor predeterminado es true (usa SQL heredado).

bq remove-iam-policy-binding

El comando remove-iam-policy-binding recupera la política de IAM para un recurso (tabla o vista) y quita una vinculación de la política, en un paso.

Este comando es una alternativa al siguiente proceso de tres pasos:

  1. Usa el comando get-iam-policy para recuperar el archivo de políticas (en formato JSON)
  2. Edita el archivo de políticas
  3. Usa el comando set-iam-policy para actualizar la política sin la vinculación

Uso: 

bq remove-iam-policy-binding --member="MEMBER" --role="ROLE" [-COMMAND_FLAGS] RESOURCE_IDENTIFIER

Estas son las marcas y el argumento específicos del comando remove-iam-policy-binding.

--member
La parte miembro de la vinculación de la política de IAM. La marca --member es obligatoria junto con la marca --role. Una combinación de --member y --role equivale a una vinculación. Consulta la referencia de la Política de IAM para obtener detalles sobre las vinculaciones.
--role
La parte de la función que pertenece a la vinculación de política de IAM. La marca --role es obligatoria, con la marca --member. Una combinación de las marcas --member y --role equivale a una vinculación. Consulta la referencia de la Política de IAM para obtener detalles sobre las vinculaciones.
-t --table/view
Cuando se especifica, quita una vinculación de la política de IAM de una tabla o vista. Opcional. El valor predeterminado es false.

RESOURCE_IDENTIFIER es el recurso (tabla o vista) cuya política se está actualizando.

bq rm

El comando rm borra un compromiso de capacidad, un conjunto de datos, un modelo, una reserva, una asignación de reserva, una tabla, una configuración de transferencia o una vista.

Para obtener más información sobre el uso del comando rm, consulta:

El comando rm usa las siguientes marcas específicas del comando.

--capacity_commitment
Cuando se especifica, borra un compromiso de capacidad. El valor predeterminado es false.
--dataset o -d
Cuando se especifica, borra un conjunto de datos. El valor predeterminado es false.
--force o -f
Cuando se especifica, borra una tabla, una vista, un modelo o un conjunto de datos sin preguntar. El valor predeterminado es false.
--model o -m
Cuando se especifica, borra un modelo de BigQuery ML.
--recursive o -r
Cuando se especifica, borra un conjunto de datos y todas las tablas, los datos de tablas o los modelos que este contenga. El valor predeterminado es false.
--reservation
Cuando se especifica, borra una reserva. El valor predeterminado es false.
--reservation_assignment
Cuando se especifica, borra una asignación de reserva. El valor predeterminado es false.
--table o -t
Cuando se especifica, borra una tabla. El valor predeterminado es false.
--transfer_config
Cuando se especifica, borra una configuración de transferencia. El valor predeterminado es false.

bq set-iam-policy

El comando set-iam-policy establece (o actualiza) la política de IAM de un recurso (tabla o vista). Una vez que establezcas la política, la política nueva se imprimirá en stdout. La política está en formato JSON.

El campo etag de la política actualizada debe coincidir con el valor etag de la política actual, de lo contrario, la actualización fallará. Esta función evita actualizaciones simultáneas.

Puedes obtener la política actual y el valor etag con el comando bq get-iam-policy.

Para obtener más información sobre el comando set-iam-policy, con ejemplos, consulta Introducción a los controles de acceso a tablas.

Uso:

bq get-iam-policy [-COMMAND_FLAG] RESOURCE_IDENTIFIER FILE_NAME

El comando set-iam-policy usa las siguientes marcas y argumentos específicos del comando.

-t --table/view
Cuando se especifica, configura la política de IAM de una tabla o vista. Opcional. El valor predeterminado es false.

RESOURCE_IDENTIFIER es el recurso (tabla o vista) cuya política se está actualizando.

FILE_NAME es el nombre de un archivo que contiene la política en formato JSON.

bq show

El comando show muestra información sobre un objeto.

Para obtener más información sobre el uso del comando show, consulta:

El comando show usa las siguientes marcas específicas del comando.

--assignee_id
Cuando se usa con la marca reservation_assignment, especifica el ID de una carpeta, una organización o un proyecto. Usa la marca --assignee_type para especificar qué tipo de usuario asignado se mostrará.
--assignee_type
Cuando se usa con la marca reservation_assignment, especifica el tipo de usuario asignado que se mostrará. Puede ser FOLDER, ORGANIZATION o PROJECT.
--reservation
Si se especifica, muestra información sobre una reserva. El valor predeterminado es false.
--dataset o -d
Cuando se especifica, muestra información sobre un conjunto de datos. El valor predeterminado es false.
--encryption_service_account
Cuando se especifica, muestra la cuenta de servicio de un usuario, si existe. En caso de que no exista, la crea. El valor predeterminado es false.
--job o -j
Si se especifica, muestra información sobre un trabajo. El valor predeterminado es false.
--job_type
Cuando se usa con la marca reservation_assignment, especifica el tipo de asignación de reserva de trabajo que se mostrará. Puede ser QUERY, PIPELINE o ML_EXTERNAL.
--model o -m
Si se especifica, muestra información sobre un modelo de BigQuery ML.
--reservation
Si se especifica, muestra información sobre una reserva. El valor predeterminado es false.
--reservation_assignment
Muestra las asignaciones de reserva de una carpeta, una organización o un proyecto especificado. Muestra las asignaciones explícitas del recurso de destino, si las hubiera. De lo contrario, muestra las asignaciones heredadas de los recursos superiores. Por ejemplo, un proyecto puede heredar asignaciones de su carpeta superior. Cuando se usa esta marca, se aplican las marcas --job_type, --assignee_type y --assignee_id.
--schema
Cuando se especifica, muestra solo el esquema de la tabla. El valor predeterminado es false.
--transfer_config
Cuando se especifica, muestra información sobre una configuración de transferencia. El valor predeterminado es false.
--transfer_run
Cuando se especifica, muestra información sobre una ejecución de transferencia. El valor predeterminado es false.
--view
Cuando se especifica, muestra información sobre una vista. El valor predeterminado es false.

bq update

El comando update actualiza un compromiso de capacidad, un conjunto de datos, un modelo, una reserva, una asignación de reserva, una tabla, una configuración de transferencia o una vista.

Para obtener más información sobre el uso del comando update, consulta:

El comando update usa las siguientes marcas específicas del comando.

--capacity_commitment
Si se especifica, actualiza un compromiso de capacidad. El valor predeterminado es false. Usa esta marca con las marcas --merge, --plan, --renewal_plan, --split y --slots.
--clear_label
Quita una etiqueta con el formato KEY:VALUE. Repite esta etiqueta para quitar varias etiquetas.
--dataset o -d
Actualiza un conjunto de datos. El valor predeterminado es false.
--default_kms_key
Establece la clave predeterminada de Cloud KMS para encriptar los datos de la tabla en un conjunto de datos. La clave predeterminada se usa si no se proporciona una clave explícita para la creación de una tabla ni una consulta.
--default_partition_expiration

Un número entero que especifica el vencimiento predeterminado (en segundos) de todas las particiones de las tablas particionadas nuevas que se crean en el conjunto de datos. Esta marca no tiene un valor mínimo.

La fecha y hora de vencimiento de una partición se determina según la suma de la fecha de la partición en formato UTC más el valor del número entero. Cuando se configura esta propiedad, se anula el vencimiento predeterminado de la tabla definido para todo el conjunto de datos, si existe. Si suministras la marca --time_partitioning_expiration cuando creas o actualizas una tabla particionada, el vencimiento de la partición a nivel de la tabla toma precedencia sobre el vencimiento predeterminado de la partición a nivel del conjunto de datos. Especifica 0 para quitar un tiempo de vencimiento existente.

--default_table_expiration

Un número entero que actualiza la duración predeterminada, en segundos, de las tablas nuevas que se crean en un conjunto de datos. La fecha y hora de vencimiento se determina mediante la suma de la hora actual en formato UTC más este valor. Especifica 0 para quitar el tiempo de vencimiento existente.

--description

Actualiza la descripción de un conjunto de datos, una tabla, un modelo o una vista.

--destination_reservation_id

Cuando se usa con la marca --reservation_assignment, mueve una asignación de reserva existente a la reserva especificada. El valor es el ID de la reserva de destino. Para obtener más información, consulta Mueve una asignación a una reserva diferente.

--display_name

Actualiza el nombre visible de una configuración de transferencia. El valor predeterminado es ''.

--etag ETAG

Actualiza el recurso solo si el recurso tiene una ETag que coincide con la string especificada en el argumento ETAG.

--expiration SECONDS

Para actualizar el vencimiento de la tabla, el modelo o la vista, incluye esta marca. Reemplaza SECONDS por la cantidad de segundos desde la hora de actualización hasta la fecha de vencimiento. Para quitar el vencimiento de una tabla, un modelo o una vista, establece el argumento SECONDS en 0.

--external_table_definition

Actualiza una tabla externa con la definición de tabla especificada. El esquema puede ser una ruta de acceso a un archivo de esquema JSON local o una lista de definiciones de columnas separadas por comas con el formato FIELD:DATA_TYPE, FIELD:DATA_TYPE. El formato para proporcionar el nombre y el esquema de la tabla es TABLE::PATH_TO_FILE o TABLE::SCHEMA@SOURCE_FORMAT=CLOUD_STORAGE_URI.

--ignore_idle_slots

Úsalo con la marca --reservation. Si es true, los trabajos que se ejecutan en la reserva especificada solo podrán usar ranuras asignadas a esa reserva. Si es false, los trabajos que se ejecutan en la reserva especificada podrán usar ranuras inactivas de otras reservas o ranuras que no están asignadas a una reserva. El valor predeterminado es false. Para obtener más información, consulta Ranuras inactivas.

--merge

Cuando se usa con la marca --capacity_commitment, combina dos compromisos de capacidad. El valor predeterminado es false. Para obtener más información, consulta Combina dos compromisos.

--model o -m

Actualiza los metadatos de un modelo de BigQuery ML.

--params o -p

Actualiza los parámetros de una configuración de transferencia en formato JSON: {"PARAMETER":"VALUE"}. Los parámetros varían según la fuente de datos. Para obtener más información, consulta Introducción al Servicio de transferencia de datos de BigQuery.

--plan

Cuando se usa con la marca --capacity_commitment, convierte un compromiso de capacidad en un plan de compromiso de mayor duración. Puede ser FLEX, MONTHLY o ANNUAL. El valor predeterminado es ''.

--refresh_window_days

Es un número entero que especifica un nuevo período de actualización (en días) para una configuración de transferencia.

--renewal_plan

Cuando se usa con la marca --capacity_commitment, especifica el plan de renovación para un compromiso de capacidad existente. Puede ser FLEX, MONTHLY o ANNUAL. El valor predeterminado es ''.

--reservation

Si se especifica, actualiza una reserva. El valor predeterminado es false.

--reservation_assignment

Si se especifica, actualiza una asignación de reserva. El valor predeterminado es false.

--schema

La ruta de acceso a un archivo de esquema JSON local o una lista de definiciones de columnas separadas por comas con el formato FIELD:DATA_TYPE,FIELD:DATA_TYPE. El valor predeterminado es ''.

--set_label

Una etiqueta para actualizar con el formato KEY:VALUE. Repite esta marca para actualizar varias etiquetas.

--slots

Cuando se usa con las marcas --capacity_commitment y --split, especifica la cantidad de ranuras para dividir de un compromiso de capacidad existente en un compromiso nuevo. Cuando se usa con la marca --reservation, actualiza la cantidad de ranuras en una reserva.

--source

La ruta a un archivo JSON local que contiene una carga útil usada para actualizar un recurso. Por ejemplo, puedes usar esta marca para especificar un archivo JSON que contenga un recurso de conjunto de datos con una propiedad access actualizada. El archivo se usa para reemplazar los controles de acceso del conjunto de datos.

--split

Cuando se usa con la marca --capacity_commitment, divide un compromiso de capacidad existente. El valor predeterminado es false. Si deseas obtener más información, consulta Divide un compromiso.

--table o -t

Cuando se especifica, actualiza una tabla. El valor predeterminado es false.

--target_dataset

Cuando se especifica, actualiza el conjunto de datos de destino de una configuración de transferencia. El valor predeterminado es ''.

--time_partitioning_expiration

Un número entero que actualiza (en segundos) cuándo se debe borrar una partición basada en el tiempo. La fecha y hora de vencimiento se evalúa según la suma de la fecha de la partición en formato UTC más el valor del número entero. Si el número es negativo, no hay vencimiento.

--time_partitioning_field

Actualiza el campo utilizado para determinar cómo crear una partición basada en el tiempo. Si la partición basada en el tiempo se habilita sin este valor, la tabla se particiona en función del tiempo de carga.

--time_partitioning_type

Especifica el tipo de partición. Los valores posibles son DAY, HOUR, MONTH o YEAR. No puedes cambiar el tipo de partición de una tabla existente.

--transfer_config

Cuando se especifica, actualiza una configuración de transferencia. El valor predeterminado es false.

--update_credentials

Cuando se especifica, actualiza las credenciales de una configuración de transferencia. El valor predeterminado es false.

--use_legacy_sql

Cuando se configura como false, actualiza la consulta de SQL de una vista de SQL heredado a SQL estándar. El valor predeterminado es true (usar SQL heredado).

--view

Cuando se especifica, actualiza la consulta de SQL de una vista. El valor predeterminado es ''.

--view_udf_resource

Actualiza el URI de Cloud Storage o la ruta a un archivo de código local que se cargará y evaluará de inmediato como recurso de función definido por el usuario en la consulta de SQL de una vista. Repite esta marca para especificar varios archivos.

bq wait

El comando wait espera algunos segundos para finalizar un trabajo.

El comando wait usa la marca global --job_id y las siguientes marcas específicas del comando.

SECONDS
Un valor de número entero mayor o igual que 0, el cual especifica el tiempo de espera (este valor no es una marca; el número entero se especifica en la línea de comandos). Si ingresas 0, el comando realiza un sondeo para determinar si se completó el trabajo y el resultado se muestra de forma inmediata. Si no especificas un número entero, el comando espera durante un período sin fin.
--fail_on_error
Cuando se especifica, una vez transcurrido el tiempo de espera, se muestra como resultado un error si el trabajo aún se está ejecutando o finalizó con errores. El valor predeterminado es true.
--wait_for_status

Cuando se especifica, espera un estado de trabajo específico antes de mostrar un resultado. Estos son algunos de los valores posibles:

  • PENDING
  • RUNNING
  • DONE

El valor predeterminado es DONE.