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
ystderr
. Si especificas la string vacía (''
), se registra enstdout
. --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 entornoBIGQUERYRC
. 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
oDATASET
. Si faltaPROJECT
, 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 enfalse
, 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 formatosparse
: genera una tabla más simpleprettyjson
: formato JSON fácil de leerjson
: JSON lo más compacto posiblecsv
: formato csv con encabezado
Las opciones
pretty
,sparse
yprettyjson
están diseñadas para que las pueda leer un ser humano. En cambio, las opcionesjson
ycsv
están pensadas para pasarlas a otro programa. Si se especificanone
, 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 entrue
, 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 esfalse
.--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. SiDEBUG_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
yquery
. 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 comandosshow
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 esfalse
.--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 comofalse
, se crea el trabajo y se usa el estado de finalización correcto para el código de error. El valor predeterminado estrue
.--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:
- Usa el comando
get-iam-policy
para recuperar el archivo de políticas (en formato JSON) - Edita el archivo de políticas
- 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 estrue
.
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) yNONE
. El valor predeterminado esNONE
. --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
ytab
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:
- Cargar datos de Avro
- Cargar datos de CSV
- Cargar datos de JSON
- Cargar datos de ORC
- Cargar datos de Parquet
- Cómo cargar datos de exportaciones de Datastore
- Carga datos de exportaciones de Cloud Firestore
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
ytab
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 enDATASTORE_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 esfalse
. Puedes usar la declaraciónTRUNCATE 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 camposREQUIRED
aNULLABLE
.
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
oYEAR
. El tipo de partición predeterminado para la partición basada en el tiempo esDAY
.
--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:
- Administra trabajos
- Haz una lista de los conjuntos de datos
- Crea y usa tablas
- Muestra una lista de las vistas de un conjunto de datos
- Trabaja con transferencias
- Trabaja con Reservations
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 formatolabels.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).Para filtrar según etiquetas de conjuntos de datos, usa las claves y los valores que aplicaste a tus conjuntos de datos. Por ejemplo:
--filter "labels.department:marketing labels.team:sales"
Para filtrar en función de las configuraciones de transferencia, usa
dataSourceIds
como clave y una de las siguientes fuentes de datos como valor:amazon_s3
: Transferencia de datos de Amazon S3dcm_dt
: Transferencia de datos de Campaign Managergoogle_cloud_storage
: Transferencia de datos de Cloud Storagecross_region_copy
: Copia de conjunto de datosdfp_dt
- Transferencia de datos de Google Ad Manageradwords
- Transferencia de datos de Google Adsmerchant_center
: Transferencia de datos de Google Merchant Centerplay
- Transferencia de datos de Google Playdoubleclick_search
- Transferencia de datos de Search Ads 360youtube_channel
: Transferencia de datos de canal de YouTubeyoutube_content_owner
: Transferencia de datos de propietario del contenido de YouTuberedshift
: Migración de Amazon Redshifton_premises
- Migración de Teradata
--filter "labels.dataSourceIds:dcm_dt"
Para filtrar en función de las ejecuciones de transferencia, usa
states
como clave y uno de los siguientes estados de transferencia como el valor:SUCCEEDED
FAILED
PENDING
RUNNING
CANCELLED
Por ejemplo:
--filter "labels.states:FAILED"
--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 esfalse
.--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:
--capacity_commitment
: Compra un compromiso de capacidad.--dataset
o-d
: Crea un conjunto de datos.--materialized_view
: Crea una vista materializada.--reservation
: Crea una reserva.--reservation_assignment
: Asigna una carpeta, organización o proyecto a una reserva.--table
o-t
: Crea una tabla.--transfer_config
: Crea una configuración de transferencia.--view
: Crea una vista.--transfer_run
: Crea una ejecución de transferencia para un intervalo de tiempo.
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 esfalse
.
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
oANNUAL
). --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 esfalse
, 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 esfalse
. 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
oPROJECT
. --job_type
- Es el tipo de trabajo que se asignará a la reserva. Puede ser
QUERY
,PIPELINE
oML_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
es0
, 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 quecolumn_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
oYEAR
.
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:
amazon_s3
: Transferencia de datos de Amazon S3dcm_dt
: Transferencia de datos de Campaign Managergoogle_cloud_storage
: Transferencia de datos de Cloud Storagecross_region_copy
: Copia de conjunto de datosdfp_dt
- Transferencia de datos de Google Ad Manageradwords
- Transferencia de datos de Google Adsmerchant_center
: Transferencia de datos de Google Merchant Centerplay
- Transferencia de datos de Google Playdoubleclick_search
- Transferencia de datos de Search Ads 360youtube_channel
: Transferencia de datos de canal de YouTubeyoutube_content_owner
: Transferencia de datos de propietario del contenido de YouTuberedshift
: Migración de Amazon Redshifton_premises
- Migración de Teradata
--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:
- Configura una transferencia de Amazon S3
- Configura una transferencia de Campaign Manager.
- Configura una transferencia de Cloud Storage.
- Configura una transferencia de Google Ad Manager.
- Configura una transferencia de Google Ads.
- Configura una transferencia de Google Merchant Center (Beta)
- Configura una transferencia de Google Play.
- Configura una transferencia de Search Ads 360 (Beta).
- Configura una transferencia de canal de YouTube
- Configura una transferencia de propietario de contenido de YouTube
- Migra datos de Amazon Redshift
- Migra datos desde Teradata
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
es0
, 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 estrue
(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
oYEAR
. El formato esperado del bloque de unidades de tiempo es YYYYMMDD paraDAY
, YYYYMMDDHH paraHOUR
, YYYYMM paraMONTH
y YYYY ParaYEAR
.
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
. EspecificaTABLE
con el siguiente formato:PROJECT
:DATASET
.TABLE
. Si no se especificaPROJECT
, 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
oTABLE::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 valorSTRING
con el formatoNAME::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 esfalse
. Para quitar todas las filas de una tabla sin borrar el esquema, usa la declaraciónTRUNCATE 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 esfalse
.--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 camposREQUIRED
aNULLABLE
.
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 sonDAY
,HOUR
,MONTH
oYEAR
.--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 estrue
(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:
- Usa el comando
get-iam-policy
para recuperar el archivo de políticas (en formato JSON) - Edita el archivo de políticas
- 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:
- Administra conjuntos de datos
- Administra tablas
- Administra vistas
- Trabaja con transferencias
- Trabaja con Reservations
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:
- Obtén información sobre los conjuntos de datos
- Crea y usa tablas
- Obtén información sobre las vistas
- Trabaja con transferencias
- Administra trabajos
- Trabaja con Reservations
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 serFOLDER
,ORGANIZATION
oPROJECT
. --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 serQUERY
,PIPELINE
oML_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:
- Actualiza las propiedades del conjunto de datos
- Administra tablas
- Actualiza propiedades de la vista
- Actualiza etiquetas
- Trabaja con transferencias
- Trabaja con Reservations
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. Especifica0
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 argumentoSECONDS
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 esTABLE::PATH_TO_FILE
oTABLE::SCHEMA@SOURCE_FORMAT=CLOUD_STORAGE_URI
.--ignore_idle_slots
Úsalo con la marca
--reservation
. Si estrue
, los trabajos que se ejecutan en la reserva especificada solo podrán usar ranuras asignadas a esa reserva. Si esfalse
, 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 esfalse
. 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 esfalse
. 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 serFLEX
,MONTHLY
oANNUAL
. 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 serFLEX
,MONTHLY
oANNUAL
. 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 esfalse
. 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
oYEAR
. 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 estrue
(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
.