Documentation de référence de l'outil de ligne de commande

Ce document présente une description détaillée des commandes et des options de l'outil de ligne de commande bq. Pour en savoir plus sur l'utilisation de l'outil de ligne de commande bq, consultez la page Utiliser l'outil de ligne de commande bq.

Options globales

L'outil de ligne de commande bq vous permet d'utiliser les options globales suivantes.

[OBSOLÈTE] Options d'autorisation bq

Les options d'autorisation bq sont obsolètes. Pour configurer une autorisation pour l'outil de ligne de commande bq, consultez la page Autoriser les outils SDK Cloud.

--application_default_credential_file
Pour plus d'informations, consultez la page Configurer l'authentification des applications de production serveur à serveur. La valeur par défaut est ''.
--credential_file
Nom de fichier utilisé pour le stockage de votre jeton OAuth. La valeur par défaut est $HOME/.bigquery.v2.token.
--service_account
Utilisez l'adresse e-mail de ce compte de service pour l'autorisation. Par exemple : 1234567890@developer.gserviceaccount.com. La valeur par défaut est ''.
--service_account_credential_file
Fichier utilisé pour le stockage des identifiants des comptes de service. Cette option doit être définie si vous utilisez un compte de service.
--service_account_private_key_file
Fichier contenant la clé privée du compte de service. Cette option est nécessaire si l'option --service_account est spécifiée. La valeur par défaut est ''.
--service_account_private_key_password
Mot de passe de la clé privée. Le mot de passe doit correspondre au mot de passe défini sur la clé lors de sa création. La valeur par défaut est notasecret.
--use_gce_service_account
Spécifiez cette option pour utiliser les identifiants du compte de service au lieu des identifiants stockés lorsque vous exécutez une instance Compute Engine. Pour en savoir plus, consultez la page Créer et activer des comptes de service pour les instances. La valeur par défaut est false.

Options bq globales

--api
Point de terminaison de l'API à appeler. La valeur par défaut est https://www.googleapis.com.

--api_versionVersion de l'API à utiliser. La valeur par défaut est v2.

--apilog
Consignez toutes les requêtes et les réponses de l'API dans le fichier spécifié par cette option. Vous pouvez utiliser stdout et stderr. Le fait de spécifier la chaîne vide ('') dirige vers stdout.
--bigqueryrc
Chemin d'accès au fichier de configuration de l'outil de ligne de commande bq. Le fichier de configuration spécifie les nouveaux paramètres par défaut des options et peut être remplacé en spécifiant l'option dans la ligne de commande. Si l'option --bigqueryrc n'est pas spécifiée, la variable d'environnement BIGQUERYRC est utilisée. Si elle n'est pas spécifiée, le chemin ~/.bigqueryrc est utilisé. La valeur par défaut est $HOME/.bigqueryrc.
--ca_certificates_file
Emplacement de votre fichier de certificat CA. La valeur par défaut est ''.
--dataset_id
Ensemble de données par défaut à utiliser pour les requêtes. Cet option est ignorée lorsqu'elle n'est pas applicable. Vous pouvez définir la valeur sur project_id:dataset ou dataset. Si project_id n'est pas indiqué, le projet par défaut est utilisé. Vous pouvez remplacer ce paramètre en spécifiant l'option --project_id. La valeur par défaut est ''.
--debug_mode
Affiche les traces sur les exceptions Python. La valeur par défaut est false.
--disable_ssl_validation
Désactive la validation du certificat HTTPS. La valeur par défaut est false.
--discovery_file
Nom du fichier JSON à lire pour la découverte. La valeur par défaut est ''.
--enable_gdrive
Si défini sur true, un nouveau jeton OAuth associé au niveau d'accès GDrive est demandé. Si défini sur false, un nouveau jeton OAuth sans niveau d'accès GDrive est demandé.
--fingerprint_job_id
Indique s'il faut utiliser un ID de tâche issu d'une empreinte de la configuration de la tâche. Empêche d'exécuter plusieurs fois la même tâche par inadvertance. La valeur par défaut est false.
--flagfile
Si une valeur est spécifiée, les définitions d'options du fichier fourni sont insérées dans l'outil de ligne de commande bq. La valeur par défaut est ''.
--format

Spécifie le format de sortie de la commande, soit :

  • pretty : sortie en tant que table formatée
  • sparse : sortie en tant que table simplifiée
  • prettyjson : format JSON facile à lire
  • json : format JSON le plus compact possible
  • csv : format CSV avec en-tête

Les formats pretty, sparse et prettyjson sont conçus pour être lisibles. Les formats json et csv sont conçus pour permettre le transfert vers un autre programme. Si la valeur none est spécifiée, la commande ne produit aucun résultat. Si l'option --format est absente, un format de sortie approprié est choisi en fonction de la commande.

--headless

Spécifie si la session bq doit être exécutée sans interaction de l'utilisateur. Si défini sur true, l'interaction est désactivée. Par exemple, debug_mode n'interfère pas avec le débogueur et la fréquence d'impression des informations est réduite. La valeur par défaut est false.

--job_id

ID de tâche unique à utiliser pour la requête. S'il n'est pas spécifié dans une requête de création de tâche, un ID de tâche est généré. Cette option ne s'applique qu'aux commandes destinées à créer des tâches : cp, extract, load et query. Pour plus d'informations, consultez la section Exécuter des tâches par programmation.

--job_property

Paire clé/valeur supplémentaire à inclure dans le champ des propriétés de la configuration de la tâche. Répétez cette option pour spécifier des propriétés supplémentaires.

--location

Chaîne correspondant à votre région ou à un emplacement multirégional. L'option d'emplacement est nécessaire pour les commandes cancel et show lorsque l'option -j est utilisée pour afficher les informations de tâche. L'option d'emplacement est facultative pour les commandes ci-dessous :

Toutes les autres commandes ignorent l'option --location.

--max_rows_per_request

Entier spécifiant le nombre maximal de lignes à renvoyer par opération de lecture.

--project_id

ID de projet à utiliser pour les requêtes. La valeur par défaut est ''.

--proxy_address

Nom ou adresse IP de l'hôte proxy à utiliser pour se connecter à Google Cloud. La valeur par défaut est ''.

--proxy_password

Mot de passe à utiliser pour s'authentifier avec l'hôte proxy. La valeur par défaut est ''.

--proxy_port

Numéro de port à utiliser pour se connecter à l'hôte proxy. La valeur par défaut est ''.

--proxy_username

Nom d'utilisateur à utiliser pour s'authentifier avec l'hôte proxy. La valeur par défaut est ''.

--quiet ou -q

Si défini sur true, permet d'ignorer les mises à jour de l'état pendant l'exécution des tâches. La valeur par défaut est false.

--synchronous_mode ou -sync

Si défini sur true, attendez que l'exécution de la commande soit terminée avant de renvoyer et utilisez l'état d'avancement de la tâche comme code d'erreur. Si défini sur false, la tâche est créée et l'état d'exécution "réussie" est utilisé pour le code d'erreur. La valeur par défaut est true.

--trace

Jeton de traçage spécifié en tant que token:token à inclure dans les requêtes API.

Options spécifiques aux commandes

L'outil de ligne de commande bq propose les options de commande ci-dessous.

bq add-iam-policy-binding

La commande add-iam-policy-binding récupère la stratégie Identity and Access Management (IAM) d'une ressource (table ou vue) et ajoute une liaison à la stratégie en une seule étape.

Il s'agit d'une alternative au processus en trois étapes qui consiste à utiliser la commande get-iam-policy pour récupérer le fichier de stratégie (au format JSON), modifier le fichier de stratégie, et à l'utilisation de la commande set-iam-policy pour mettre à jour la stratégie avec une nouvelle liaison.

Utilisation :

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

La commande add-iam-policy-binding utilise les options et arguments de commande spécifiques suivants :

--member
Partie de la liaison de stratégie IAM correspondant au membre. L'option --member doit être spécifiée avec l'option --role. Une combinaison de --member et --role équivaut à une liaison. Pour en savoir plus sur les liaisons, consultez la documentation de référence de la stratégie IAM.
--role
Partie de la liaison de stratégie IAM correspondant au rôle. L'option --role doit être spécifiée avec l'option --member. Une combinaison des options --member et --role équivaut à une liaison. Pour en savoir plus sur les liaisons, consultez la documentation de référence de la stratégie IAM.
-t --table/view
Si spécifié, ce paramètre ajoute une liaison à la stratégie IAM d'une table ou d'une vue. Facultatif. La valeur par défaut est false.

RESOURCE_IDENTIFIER est la ressource (table ou vue) dont la stratégie est en cours de mise à jour.

bq cancel

La commande cancel permet d'annuler des tâches. La commande cancel ne comporte pas d'option spécifique à la commande.

Pour plus d'informations sur l'utilisation de la commande cancel, consultez la page Gérer les tâches.

La commande cancel utilise les options globales suivantes.

--job_id
ID de tâche unique à utiliser pour la requête d'annulation. Vous pouvez le spécifier sans utiliser l'option --job_id. Exemple : bq cancel [JOB_ID].
--synchronous_mode ou --sync
Si spécifié, attend que l'exécution de la commande soit terminée avant de renvoyer. Si défini sur false, la commande est immédiatement renvoyée. La valeur par défaut est true.

bq cp

La commande cp permet de copier des tables. Voici les options spécifiques que la commande cp utilise :

Pour plus d'informations sur l'utilisation de la commande cp, consultez la page Gérer les tables.

--append_table ou -a
Si spécifié, copie une table et l'ajoute à une table existante. La valeur par défaut est false.
--destination_kms_key
Clé Cloud KMS permettant de chiffrer les données de la table de destination.
--force ou -f
Si spécifié et si la table de destination existe, remplace celle-ci et n'affiche aucune invite. La valeur par défaut est false.
--no_clobber ou -n
Si spécifié et si la table de destination existe, ne remplace pas celle-ci. La valeur par défaut est false.

bq extract

La commande extract permet d'exporter des données de table vers Cloud Storage.

Pour plus d'informations sur l'utilisation de la commande extract, consultez la page Exporter des données de table.

Voici les options spécifiques que la commande extract utilise :

--compression
Type de compression à utiliser pour les fichiers exportés. Valeurs possibles : GZIP (CSV et JSON uniquement), DEFLATE (Avro uniquement), SNAPPY (Avro uniquement) et NONE. La valeur par défaut est NONE.
--destination_format

Format des données exportées. Les valeurs possibles sont les suivantes :

  • CSV
  • NEWLINE_DELIMITED_JSON
  • AVRO

La valeur par défaut est CSV.

--field_delimiter ou -F

Caractère indiquant la délimitation entre les colonnes du fichier de sortie pour les exportations au format CSV. Les options \t et tab sont autorisées pour les délimiteurs de tabulation.

--print_header

Si spécifié, affiche les lignes d'en-tête pour les formats comportant des en-têtes. La valeur par défaut est true.

bq get-iam-policy

La commande get-iam-policy récupère la stratégie IAM d'une ressource (table ou vue) et l'affiche sur stdout. La stratégie est au format JSON.

Pour plus d'informations sur la commande get-iam-policy et pour obtenir des exemples, consultez la page Présentation des contrôles d'accès aux tables.

Utilisation :

bq get-iam-policy [-COMMAND_FLAG] RESOURCE_IDENTIFIER

Voici l'option spécifique que la commande get-iam-policy utilise.

-t --table/view

Si spécifié, permet d'obtenir la stratégie IAM d'une table ou d'une vue. Facultatif. La valeur par défaut est false.

RESOURCE_IDENTIFIER est la ressource (table ou vue) dont la stratégie est en cours de mise à jour.

bq head

La commande head affiche les lignes d'une table.

Pour plus d'informations sur l'utilisation de la commande head, consultez la page Gérer des données de tables.

Voici les options spécifiques que la commande head utilise :

--job ou -j
Spécifiez cette option avec un ID de tâche valide pour lire les résultats d'une tâche de requête. La valeur par défaut est false.
--max_rows ou -n
Entier indiquant le nombre de lignes à afficher lors de l'affichage des données de la table. La valeur par défaut est 100.
--selected_fields ou -c
Liste séparée par des virgules indiquant un sous-ensemble de champs à renvoyer (y compris les champs imbriqués et répétés) lors de l'affichage des données de la table. Si non spécifié, toutes les colonnes sont récupérées.
--start_row ou -s
Entier indiquant le nombre de lignes à ignorer avant d'afficher les données de la table. La valeur par défaut est 0 (commencer à la première ligne).
--table ou -t
Spécifiez cette option avec un ID de table pour lire les lignes d'une table. La valeur par défaut est false.

bq insert

La commande insert vous permet d'insérer des lignes de données au format JSON délimitées par un retour à la ligne en utilisant le tampon d'insertion en flux continu. Les types de données sont convertis pour correspondre aux types de colonnes de la table de destination. Cette commande est conçue à des fins de test uniquement. Pour diffuser des données en flux continu dans BigQuery, utilisez la méthode API insertAll.

Pour plus d'informations, consultez la page Insérer des données en flux continu dans BigQuery.

Voici les options spécifiques que la commande insert utilise :

--ignore_unknown_values ou -i
Si spécifié, ignore les valeurs d'une ligne qui ne sont pas présentes dans le schéma de la table.
--skip_invalid_rows ou -s
Si spécifié, tente d'insérer des lignes valides, même si des lignes non valides sont présentes.
--template_suffix ou -x
Si spécifié, traite la table de destination comme un modèle de base, puis insère les lignes dans une table d'instance nommée {destination}{templateSuffix}. BigQuery gère la création de la table d'instance à l'aide du schéma du modèle de base.

bq load

La commande load charge les données dans une table.

Pour en savoir plus sur le chargement de données depuis Cloud Storage à l'aide de la commande load, consultez la section suivante :

Pour en savoir plus sur le chargement de données à partir d'une source locale à l'aide de la commande load, consultez la page Charger des données à partir de fichiers locaux.

Voici les options spécifiques que la commande load utilise :

--allow_jagged_rows
Si spécifié, autorise les colonnes finales facultatives manquantes dans les données CSV.
--allow_quoted_newlines
Si spécifié, autorise les nouvelles lignes entre guillemets dans les données CSV.
--autodetect
Si spécifié, active la détection automatique du schéma pour les données CSV et JSON.
--clustering_fields
Liste incluant jusqu'à quatre noms de colonne séparés par des virgules.
--destination_kms_key
Clé Cloud KMS pour le chiffrement des données de la table de destination.
--encoding ou -E
Encodage de caractères utilisé dans les données. Les valeurs possibles sont les suivantes :
  • ISO-8859-1 (également appelé Latin-1)
  • UTF-8
--field_delimiter ou -F
Caractère indiquant la délimitation entre les colonnes de données. Les options \t et tab sont autorisées pour les délimiteurs de tabulation.
--ignore_unknown_values
Si spécifié pour les fichiers CSV et JSON, les lignes dont les valeurs de colonnes supplémentaires ne correspondent pas au schéma sont ignorées et ne sont pas chargées. De même, les champs définis dans le schéma des fichiers Avro, Parquet et ORC qui n'existent pas dans le schéma de la table sont ignorés et ne sont pas chargés.
--max_bad_records
Entier spécifiant le nombre maximal d'enregistrements incorrects autorisés avant l'échec total de la tâche. La valeur par défaut est 0. Au plus, cinq erreurs de n'importe quel type sont renvoyées, quelle que soit la valeur --max_bad_records.
--null_marker
Chaîne personnalisée facultative qui représente une valeur NULL dans les données CSV.
--projection_fields
Si utilisé avec le paramètre --source_format défini sur DATASTORE_BACKUP, indique les propriétés d'entité à charger à partir d'une exportation Datastore sous forme de liste séparée par des virgules. Les noms de propriétés sont sensibles à la casse et doivent faire référence à des propriétés de niveau supérieur. La valeur par défaut est ''. Cette option peut également être utilisée avec les exportations Firestore.
--quote
Guillemet à utiliser pour délimiter les enregistrements. La valeur par défaut est ". Pour ne spécifier aucun guillemet, utilisez une chaîne vide.
--replace
Si une valeur est spécifiée, les données et le schéma existants sont effacés lors du chargement de nouvelles données. Les clés Cloud KMS sont également supprimées, sauf si vous spécifiez l'option --destination_kms_key. La valeur par défaut est false. Vous pouvez utiliser l'instruction TRUNCATE TABLE pour supprimer toutes les lignes d'une table sans supprimer le schéma.
--schema
Chemin d'accès à un fichier de schéma JSON local, ou liste de définitions de colonnes séparées par des virgules au format field:data_type, field:data_type.
--schema_update_option

Lorsque vous ajoutez des données à une table (dans une tâche de chargement ou de requête) ou que vous remplacez une partition de table, spécifie comment mettre à jour le schéma de la table de destination. Les valeurs possibles sont les suivantes :

  • ALLOW_FIELD_ADDITION : autoriser l'ajout de nouveaux champs
  • ALLOW_FIELD_RELAXATION : autoriser l'assouplissement des champs REQUIRED sur NULLABLE

Répétez cette option pour spécifier plusieurs options de mise à jour de schéma.

--skip_leading_rows

Entier qui spécifie le nombre de lignes à ignorer au début du fichier source.

--source_format

Format des données source. Les valeurs possibles sont les suivantes :

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

Entier qui spécifie (en secondes) le moment où une partition temporelle doit être supprimée. Le délai d'expiration correspond à la date UTC de la partition plus la valeur entière. Un nombre négatif indique l'absence de délai d'expiration.

--time_partitioning_field

Champ utilisé pour déterminer comment créer une partition temporelle. Si le partitionnement temporel est activé sans cette valeur, la table est partitionnée en fonction de la date de chargement.

--time_partitioning_type

Active le partitionnement temporel sur une table et définit le type de partition. Les valeurs possibles sont DAY, HOUR, MONTH ou YEAR.

--use_avro_logical_types

Si sourceFormat est défini sur AVRO, indique s'il faut convertir les types logiques en types correspondants tels que TIMESTAMP, au lieu de n'utiliser que leurs types bruts tels que INTEGER.

bq ls

La commande ls répertorie les objets d'une collection.

Pour plus d'informations sur l'utilisation de la commande ls, consultez les pages ci-dessous :

Voici les options spécifiques que la commande ls utilise :

--all ou -a
Si spécifié, affiche tous les résultats : tâches de tous les utilisateurs ou de tous les ensembles de données (y compris les ensembles masqués). Cette option n'est pas nécessaire pour répertorier les configurations ou les exécutions de transferts.
--capacity_commitment
Si spécifié, répertorie les ensembles de données. La valeur par défaut est false.
--datasets ou -d
Si spécifié, répertorie les ensembles de données. La valeur par défaut est false.
--filter
Répertorie les ensembles de données qui correspondent à l'expression de filtre. Utilise une liste de clés de libellés et de valeurs séparées par des espaces au format labels.key:value. Pour les configurations de transfert, une expression de filtre au format dataSourceIds:data_sources répertorie les configurations de transfert pour les sources de données spécifiées. Les valeurs possibles sont les suivantes :
  • dcm_dt : Campaign Manager
  • dcm_dt : Campaign Manager
  • google_cloud_storage : Cloud Storage
  • dfp_dt : Google Ad Manager
  • adwords : Google Ads
  • merchant_center : Google Merchant Center
  • play : Google Play
  • doubleclick_search : Search Ads 360
  • youtube_channel : rapports de chaîne YouTube
  • youtube_content_owner : rapports du propriétaire de contenu YouTube

Concernant les exécutions de transferts, une expression de filtre au format states:state répertorie les exécutions de transferts avec les états spécifiés. Les valeurs possibles sont les suivantes :

  • SUCCEEDED
  • FAILED
  • PENDING
  • RUNNING
  • CANCELLED
--jobs ou -j
Si spécifié, répertorie les tâches. La valeur par défaut est false. Par défaut, les résultats sont limités à 100 000.
--max_creation_time
Entier représentant un horodatage en millisecondes. Avec l'option -j, répertorie les tâches créées avant l'horodatage.
--max_results ou -n
Entier indiquant le nombre maximal de résultats. La valeur par défaut est 50.
--min_creation_time
Entier représentant un horodatage en millisecondes. Avec l'option -j, répertorie les tâches créées après l'horodatage.
--message_type

Pour répertorier les messages du journal d'exécution de transferts d'un type particulier, spécifiez messageTypes:message_type. Les valeurs possibles sont les suivantes :

  • INFO
  • WARNING
  • ERROR
--models ou -m

Si spécifié, répertorie les modèles BigQuery ML.

--page_token ou -k

Si spécifié, répertorie des éléments à partir de ce jeton de page.

--projects ou -p

Si spécifié, affiche tous les projets. La valeur par défaut est false.

--reservation

Si spécifié, répertorie toutes les réservations pour un projet et un emplacement donnés. La valeur par défaut est false.

--reservation_assignment

Si spécifié, répertorie toutes les attributions de réservation pour un projet et un emplacement donnés. La valeur par défaut est false.

--run_attempt

Définissez cette option sur LATEST pour ne répertorier que les dernières exécutions de transferts.

--transfer_config

Si spécifié, répertorie les configurations de transfert. Lorsque vous utilisez cette option, vous devez également spécifier --transfer_location. La valeur par défaut est false.

--transfer_location

Répertorie les configurations de transfert à l'emplacement spécifié. Vous définissez l'emplacement de transfert lors de la création du transfert.

--transfer_log

Si spécifié, répertorie les messages du journal de transfert pour l'exécution du transfert spécifiée. La valeur par défaut est false.

--transfer_run

Si spécifié, répertorie les exécutions de transferts. La valeur par défaut est false.

bq mk

La commande mk crée diverses ressources BigQuery, y compris des ensembles de données, des tables, des vues, des vues matérialisées et des configurations de transfert.

La commande mk utilise une option de type qui spécifie le type de ressource à créer et d'autres options qui dépendent du type de ressource.

bq mk TYPE_FLAG [ OTHER FLAGS ] [ ARGS ]

TYPE_FLAG correspond à l'une des options suivantes :

En plus des options spécifiques à la commande répertoriées ci-dessous, bq mk accepte l'option suivante :

--force ou -f
Ignorer les erreurs si une ressource portant le même nom existe déjà. Si spécifié et qu'une ressource existe déjà, le code de sortie est 0. Avec cette option, la commande mk n'écrase pas la ressource. La valeur par défaut est false.

bq mk --capacity_commitment

Acheter un engagement de capacité. Pour en savoir plus, consultez la section Utiliser des engagements. Les options suivantes sont acceptées :

--location
Emplacement du projet.
--plan
Type de forfait. Au choix : FLEX, MONTHLY ou ANNUAL.
--project_id
ID du projet qui administrera les emplacements.
--slots
Nombre d'emplacements à acheter.

bq mk --dataset

Crée un ensemble de données. Pour en savoir plus, consultez la page Créer des ensembles de données. Les options suivantes sont acceptées :

--data_location
(Ancien) Spécifie l'emplacement de l'ensemble de données. Utilisez plutôt l'option globale --location.
--default_kms_key
Clé Cloud KMS employée pour chiffrer les données de la table dans un ensemble de données si aucune clé explicite n'est fournie lors de la création de la table ou de la requête.
--default_partition_expiration
Entier spécifiant le délai d'expiration par défaut en secondes pour toutes les partitions des tables partitionnées nouvellement créées dans l'ensemble de données. Le délai d'expiration d'une partition est défini sur la date UTC de la partition plus la valeur entière. Si cette propriété est définie, elle remplace le délai d'expiration de la table par défaut au niveau de l'ensemble de données, si celle-ci existe. Si vous spécifiez l'option --time_partitioning_expiration lors de la création ou de la mise à jour d'une table partitionnée, le délai d'expiration des partitions défini au niveau de la table est prioritaire sur le délai d'expiration des partitions défini par défaut au niveau de l'ensemble de données.
--default_table_expiration
Entier qui spécifie la durée de vie par défaut en secondes des tables nouvellement créées dans un ensemble de données. Le délai d'expiration correspond à l'heure UTC actuelle plus la valeur entière.
--description
Description de l'ensemble de données.
--label
Libellé pour l'ensemble de données. Il a le format suivant : key:value. Répétez cette option pour spécifier plusieurs libellés.

bq mk --materialized_view

Crée une vue matérialisée. Les options suivantes sont acceptées :

--enable_refresh
Indique si l'actualisation automatique est activée pour une vue matérialisée. La valeur par défaut lors de la création d'une vue matérialisée est true.
--refresh_interval_ms
Durée, en millisecondes, de l'intervalle d'actualisation d'une vue matérialisée. S'il n'est pas spécifié, l'intervalle d'actualisation d'une vue matérialisée pour laquelle l'actualisation est activée est de 1 800 000 millisecondes, soit 30 minutes.

Pour plus d'informations, consultez la page Créer et utiliser des vues matérialisées.

bq mk --reservation

Crée une réservation avec des emplacements dédiés. Pour en savoir plus, consultez la section Utiliser des réservations. Les options suivantes sont acceptées :

--ignore_idle_slots
Si la valeur définie est true, les tâches exécutées dans cette réservation n'utiliseront que les emplacements alloués à la réservation. Si la valeur définie est false, les tâches de cette réservation peuvent utiliser des emplacements inactifs provenant d'autres réservations, ou des emplacements qui ne sont pas alloués à une réservation. La valeur par défaut est false. Pour en savoir plus, consultez la section Emplacements inactifs.
--location
Emplacement du projet.
--project_id
ID du projet propriétaire de la réservation.
--slots
Nombre d'emplacements à allouer à cette réservation.

bq mk --reservation_assignment

Attribue un projet, un dossier ou une organisation à une réservation. Pour en savoir plus, consultez la section Utiliser des engagements. Les options suivantes sont acceptées :

--assignee_id
ID du dossier, de l'organisation ou du projet.
--assignee_type
Type d'entité à attribuer à la réservation. Spécifiez l'un des types suivants : FOLDER, ORGANIZATION ou PROJECT.
--job_type
Type de tâche à attribuer à la réservation. Spécifiez l'un des types suivants : QUERY, PIPELINE ou ML_EXTERNAL.
--location
Emplacement du projet.
--project_id
ID du projet propriétaire de la réservation.
reservation_id
ID de la réservation.

bq mk --table

Crée une table. Pour en savoir plus, consultez la page Créer et utiliser des tables. Les options suivantes sont acceptées :

--clustering_fields
Liste de noms de colonnes, séparés par des virgules, utilisée pour mettre une table en cluster. Si l'option est spécifiée, la table est mise en cluster à l'aide des colonnes fournies. Si l'option est spécifiée avec le partitionnement, la table est d'abord partitionnée, puis chaque partition est mise en cluster à l'aide des colonnes fournies.
--description
Description de la table.
--destination_kms_key
Clé Cloud KMS utilisée pour chiffrer les données de la table.
--expiration
Entier spécifiant le délai d'expiration de la table. Le délai d'expiration correspond à l'heure UTC actuelle plus la valeur entière.
--external_table_definition
Spécifie une définition de table à utiliser pour créer une table externe. La valeur peut être une définition de table intégrée ou un chemin d'accès à un fichier contenant une définition de table JSON. Le format d'une définition intégrée est schema@format=uri.
--label
Libellé à appliquer à la table. Il a le format suivant : key:value. Répétez cette option pour spécifier plusieurs libellés.
--range_partitioning

Spécifie les options pour une partition par plages d'entiers, sous la forme d'une liste d'éléments séparés par des virgules au format column_name,start,end,interval, où

  • column_name est la colonne utilisée pour créer les partitions de la plage d'entiers.
  • start est la valeur de début inclusive du partitionnement par plages.
  • end est la valeur de fin exclusive du partitionnement par plages.
  • interval est la largeur de chaque plage au sein de la partition.
--require_partition_filter

Si spécifiée, cette option détermine s'il est nécessaire de recourir à un filtre de partition pour exécuter les requêtes sur la table fournie. Cette option ne s'applique qu'aux tables partitionnées. La valeur par défaut est false.

--schema

Chemin d'accès à un fichier de schéma JSON local, ou liste de définitions de colonnes séparées par des virgules au format field:data_type,field:data_type. La valeur par défaut est ''.

--time_partitioning_expiration

Entier qui spécifie (en secondes) le moment où une partition temporelle doit être supprimée. Le délai d'expiration correspond à la date UTC de la partition plus la valeur entière. Un nombre négatif indique l'absence de délai d'expiration.

--time_partitioning_field

Champ utilisé pour déterminer comment créer une partition temporelle. Si le partitionnement temporel est activé sans cette valeur, la table est partitionnée en fonction de la date de chargement.

--time_partitioning_type

Active le partitionnement temporel sur une table et définit le type de partition. Les valeurs possibles sont DAY, HOUR, MONTH ou YEAR.

bq mk --transfer_config

Crée une configuration de transfert. Les options suivantes sont acceptées :

--data_source
Spécifie la source de données. Obligatoire lors de l'établissement d'une configuration de transfert. Les valeurs possibles sont les suivantes :
  • dcm_dt : Campaign Manager
  • dcm_dt : Campaign Manager
  • google_cloud_storage : Cloud Storage
  • dfp_dt : Google Ad Manager
  • adwords : Google Ads
  • merchant_center : Google Merchant Center
  • play : Google Play
  • doubleclick_search : Search Ads 360
  • youtube_channel : rapports de chaîne YouTube
  • youtube_content_owner : rapports du propriétaire de contenu YouTube

La valeur par défaut est ''.

--display_name
Nom d'affichage pour la configuration de transfert. La valeur par défaut est ''.
--params ou -p
Paramètres pour la configuration de transfert au format JSON : {"parameter":"value"}. Les paramètres varient en fonction de la source de données. Pour plus d'informations, consultez la page Présentation du service de transfert de données BigQuery.
--refresh_window_days
Entier spécifiant la fenêtre d'actualisation pour la configuration de transfert en jours. La valeur par défaut est 0.
--target_dataset
Ensemble de données cible pour la configuration de transfert. La valeur par défaut est ''.

Pour plus d'informations sur l'utilisation de la commande mk avec le service de transfert de données BigQuery, consultez les pages suivantes :

bq mk --transfer_run

Crée une exécution de transfert. Les options suivantes sont acceptées :

--start_time
Horodatage qui spécifie l'heure de début d'une plage d'exécutions de transferts. Le format de l'horodatage est le suivant : RFC3339 UTC "Zulu".
--end_time
Horodatage qui spécifie l'heure de fin d'une plage d'exécutions de transferts. Le format de l'horodatage est le suivant : RFC3339 UTC "Zulu".

bq mk --view

Crée une vue. Pour plus d'informations, consultez la page Créer des vues. Les options suivantes sont acceptées :

--description
Description de la vue.
--expiration
Entier spécifiant le délai d'expiration de la vue. Le délai d'expiration correspond à l'heure UTC actuelle plus la valeur entière.
--label
Libellé à appliquer à la vue. Il a le format suivant : key:value. Répétez cette option pour spécifier plusieurs libellés.
--use_legacy_sql
Lorsque ce paramètre est défini sur false, il utilise une requête SQL standard pour créer une vue. La valeur par défaut est true (utilise l'ancien SQL).
--view_udf_resource
URI Cloud Storage ou chemin d'accès à un fichier de code local chargé et évalué immédiatement en tant que ressource de fonction définie par l'utilisateur utilisée par la requête SQL d'une vue. Répétez cette option pour spécifier plusieurs fichiers.

bq mkdef

La commande mkdef crée une définition de table au format JSON pour les données stockées dans Cloud Storage ou Drive.

Pour plus d'informations sur l'utilisation de la commande mkdef, consultez la page Créer un fichier de définition de table pour une source de données externe.

Voici les options spécifiques que la commande mkdef utilise :

--autodetect
Si spécifié, permet d'utiliser la détection automatique de schéma pour les données CSV et JSON.
--ignore_unknown_values ou -i
Si spécifié, permet d'ignorer les valeurs d'une ligne qui ne sont pas présentes dans le schéma.
--source_format
Format des données source. Les valeurs possibles sont les suivantes :
  • CSV
  • NEWLINE_DELIMITED_JSON
  • AVRO
  • DATASTORE_BACKUP
  • GOOGLE_SHEETS La valeur par défaut est CSV.

bq partition

La commande partition permet de convertir les tables nommées par date (se terminant par YYYYMMDD) en tables partitionnées.

Pour plus d'informations sur l'utilisation de la commande partition, consultez la page Convertir des tables segmentées par date en tables partitionnées par date d'ingestion.

Voici les options spécifiques que la commande partition utilise :

--no_clobber ou -n
Si spécifié, ne remplace pas une partition existante. La valeur par défaut est false.
--time_partitioning_expiration
Entier qui spécifie (en secondes) le moment où une partition temporelle doit être supprimée. Le délai d'expiration correspond à la date UTC de la partition plus la valeur entière. Un nombre négatif indique l'absence de délai d'expiration.
--time_partitioning_type
Spécifie le type de partition. Les valeurs possibles sont DAY, HOUR, MONTH ou YEAR.

bq query

La commande query crée une tâche de requête qui exécute la requête SQL fournie.

Pour plus d'informations sur l'utilisation de la commande query, consultez la page Exécuter des requêtes interactives et par lot.

Voici les options spécifiques que la commande query utilise :

--allow_large_results
Si spécifié, active des tailles de tables de destination importantes pour les requêtes en ancien SQL.
--append_table
Si spécifié, ajoute des données à une table de destination. La valeur par défaut est false.
--batch
Si spécifié, exécute la requête en mode de traitement par lot. La valeur par défaut est false.
--clustering_fields
Si spécifié, une liste de colonnes séparées par des virgules permet de mettre la table de destination en cluster dans une requête. Si spécifiée, la table est mise en cluster à l'aide des colonnes fournies. Si spécifiée avec le partitionnement, la table est d'abord partitionnée, puis chaque partition est mise en cluster à l'aide des colonnes fournies.
--destination_kms_key
Clé Cloud KMS utilisée pour chiffrer les données de la table de destination.
--destination_schema
Chemin d'accès à un fichier de schéma JSON local, ou liste de définitions de colonnes séparées par des virgules au format field:data_type,field:data_type. La valeur par défaut est ''.
--destination_table TABLE_ID

Si spécifié, les résultats de la requête sont enregistrés dans TABLE_ID. Spécifiez TABLE_ID au format suivant : PROJECT:DATASET.TABLE. Si PROJECT n'est pas spécifié, le projet actuel est utilisé. Si l'option --destination_table n'est pas spécifiée, les résultats de la requête sont enregistrés dans une table temporaire.

Par exemple :

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

Si spécifié, la requête est validée, mais pas exécutée.

--external_table_definition

Nom de table et définition de schéma utilisés dans une requête de table externe. Le schéma peut être un chemin d'accès à un fichier de schéma JSON local ou à une liste de définitions de colonnes séparées par des virgules au format field:data_type,field:data_type. Le format de définition du nom et du schéma de la table est le suivant : table::path_to_file ou table::schema@source_format=cloud_storage_uri. Répétez cette option pour interroger plusieurs tables.

--flatten_results

Si spécifié, aplatit les champs imbriqués et répétés dans les résultats des requêtes en ancien SQL existantes. La valeur par défaut est true.

--label

Libellé à appliquer à une tâche de requête au format key:value. Répétez cette option pour spécifier plusieurs libellés.

--max_rows ou -n

Entier indiquant le nombre de lignes à renvoyer dans les résultats de la requête. La valeur par défaut est 100.

--maximum_bytes_billed

Entier qui limite le nombre d'octets facturés pour la requête. Si la requête dépasse la limite, elle échoue (sans frais). Si le paramètre n'est pas spécifié, le nombre d'octets facturés est défini sur la valeur par défaut du projet.

--min_completion_ratio

[Expérimental] Nombre compris entre 0 et 1.0 qui spécifie la fraction minimale de données à analyser avant le renvoi d'une requête. Si non défini, la valeur de serveur par défaut 1.0 est utilisée.

--parameter

Fichier JSON contenant une liste de paramètres de requête, ou un paramètre de requête au format name:type:value. Un nom vide crée un paramètre positionnel. Le paramètre type peut être omis pour suggérer une valeur STRING au format name::value ou ::value. Le paramètre NULL génère une valeur nulle. Répétez cette option pour spécifier plusieurs paramètres.

--replace

Si spécifié, remplace la table de destination par les résultats de la requête. Les données et les schémas existants sont effacés. Les clés Cloud KMS sont également supprimées, sauf si vous spécifiez l'option --destination_kms_key. La valeur par défaut est false. Vous pouvez utiliser l'instruction TRUNCATE TABLE pour supprimer toutes les lignes d'une table sans supprimer le schéma.

--require_cache

Si spécifié, n'exécute la requête que si les résultats peuvent être récupérés du cache.

--require_partition_filter

Si spécifié, un filtre de partition est nécessaire pour exécuter des requêtes sur la table fournie. Cette option ne peut être utilisée qu'avec une table partitionnée.

--rpc

Si spécifié, utilisez l'API de requête de style RPC à la place de la méthode jobs.insert de l'API REST. La valeur par défaut est false.

--schedule

Définit une requête programmée récurrente. La fréquence programmée d'exécution de la requête est requise. Exemples :

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

Lorsque vous ajoutez des données à une table (dans une tâche de chargement ou de requête) ou que vous remplacez une partition de table, spécifie comment mettre à jour le schéma de la table de destination. Les valeurs possibles sont les suivantes :

  • ALLOW_FIELD_ADDITION : autoriser l'ajout de nouveaux champs
  • ALLOW_FIELD_RELAXATION : autoriser l'assouplissement des champs REQUIRED sur NULLABLE

Répétez cette option pour spécifier plusieurs options de mise à jour de schéma.

--start_row ou -s

Entier spécifiant la première ligne à renvoyer dans le résultat de la requête. La valeur par défaut est 0.

--target_dataset

Si spécifié avec --schedule, met à jour l'ensemble de données cible pour une requête programmée. Il doit s'agir d'une requête LDD ou LMD.

--time_partitioning_expiration

Entier qui spécifie (en secondes) le moment où une partition temporelle doit être supprimée. Le délai d'expiration correspond à la date UTC de la partition plus la valeur entière. Un nombre négatif indique l'absence de délai d'expiration.

--time_partitioning_field

Champ utilisé pour déterminer comment créer une partition temporelle. Si le partitionnement temporel est activé sans cette valeur, la table est partitionnée en fonction de la date de chargement.

--time_partitioning_type

Avec l'option destination_table, spécifie le type de partition de la table de destination. Les valeurs possibles sont DAY, HOUR, MONTH ou YEAR.

--udf_resource

Cette option ne s'applique qu'aux requêtes en ancien SQL. Lorsqu'il est spécifié, il s'agit de l'URI Cloud Storage ou du chemin d'accès à un fichier de code local chargé et évalué immédiatement en tant que ressource de fonction définie par l'utilisateur, employée par une requête en ancien SQL. Répétez cette option pour spécifier plusieurs fichiers.

--use_cache

Si spécifié, met en cache les résultats de la requête. La valeur par défaut est true.

--use_legacy_sql

Si défini sur false, exécute une requête SQL standard. La valeur par défaut est true (utilise l'ancien SQL).

bq remove-iam-policy-binding

La commande remove-iam-policy-binding récupère la stratégie IAM d'une ressource (table ou vue) et supprime une liaison de la stratégie en une seule étape.

Il s'agit d'une alternative au processus en trois étapes qui consiste à utiliser la commande get-iam-policy pour récupérer le fichier de stratégie (au format JSON), modifier le fichier de stratégie, et à l'utilisation de la commande set-iam-policy pour mettre à jour la stratégie sans la nouvelle liaison.

Utilisation :

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

La commande remove-iam-policy-binding utilise les options et arguments de commande spécifiques suivants :

--member
Partie de la liaison de stratégie IAM correspondant au membre. L'option --member doit être spécifiée avec l'option --role. Une combinaison de --member et --role équivaut à une liaison. Pour en savoir plus sur les liaisons, consultez la documentation de référence de la stratégie IAM.
--role
Partie de la liaison de stratégie IAM correspondant au rôle. L'option --role doit être spécifiée avec l'option --member. Une combinaison des options --member et --role équivaut à une liaison. Pour en savoir plus sur les liaisons, consultez la documentation de référence de la stratégie IAM.
-t --table/view
Si spécifié, supprime une liaison de la stratégie IAM d'une table ou d'une vue. Facultatif. La valeur par défaut est false.

RESOURCE_IDENTIFIER est la ressource (table ou vue) dont la stratégie est en cours de mise à jour.

bq rm

La commande rm supprime un engagement de capacité, un ensemble de données, un modèle, une réservation, une attribution de réservation, une table, une configuration de transfert ou une vue.

Pour plus d'informations sur l'utilisation de la commande rm, consultez les pages ci-dessous :

Voici les options spécifiques que la commande rm utilise :

--capacity_commitment
Si spécifié, supprime un engagement de capacité. La valeur par défaut est false.
--dataset ou -d
Si spécifié, supprime un ensemble de données. La valeur par défaut est false.
--force ou -f
Si spécifié, supprime une table, une vue, un modèle ou un ensemble de données sans afficher d'invite. La valeur par défaut est false.
--model ou -m
Si spécifié, supprime un modèle BigQuery ML.
--recursive ou -r
Si spécifié, supprime un ensemble de données et toutes les tables, les données de table ou les modèles qu'il contient. La valeur par défaut est false.
--reservation
Si spécifié, supprime une réservation. La valeur par défaut est false.
--reservation_assignment
Si spécifié, supprime une attribution de réservation. La valeur par défaut est false.
--table ou -t
Si spécifié, supprime une table. La valeur par défaut est false.
--transfer_config
Si spécifié, supprime une configuration de transfert. La valeur par défaut est false.

bq set-iam-policy

La commande set-iam-policy définit (ou met à jour) la stratégie IAM d'une ressource (table ou vue). Une fois la stratégie définie, la nouvelle stratégie est affichée sur stdout. La stratégie est au format JSON.

Le champ etag de la stratégie mise à jour doit correspondre à la valeur etag de la stratégie actuelle. Sinon, la mise à jour échoue. Cette fonctionnalité empêche les mises à jour simultanées.

Vous pouvez obtenir la stratégie actuelle et la valeur etag avec la commande bq get-iam-policy.

Pour plus d'informations sur la commande set-iam-policy et pour obtenir des exemples, consultez la page Présentation des contrôles d'accès aux tables.

Utilisation :

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

Voici les options et arguments spécifiques à la commande set-iam-policy.

-t --table/view
Si spécifié, définit la stratégie IAM d'une table ou d'une vue. Facultatif. La valeur par défaut est false.

RESOURCE_IDENTIFIER est la ressource (table ou vue) dont la stratégie est en cours de mise à jour.

FILE_NAME est un nom de fichier contenant la stratégie au format JSON.

bq show

La commande show affiche les informations relatives à un objet.

Pour plus d'informations sur l'utilisation de la commande show, consultez les pages ci-dessous :

Voici les options spécifiques que la commande show utilise :

--assignee_id
Avec l'option reservation_assignment, spécifie l'ID d'un dossier, d'une organisation ou d'un projet. Utilisez l'option --assignee_type pour spécifier le type de responsable à afficher.
--assignee_type
Avec l'option reservation_assignment, spécifie le type de responsable à afficher. Spécifiez l'un des types suivants : FOLDER, ORGANIZATION ou PROJECT.
--reservation
Si spécifié, affiche les informations concernant une réservation. La valeur par défaut est false.
--dataset ou -d
Si spécifié, affiche les informations relatives à un ensemble de données. La valeur par défaut est false.
--encryption_service_account
Si spécifié, affiche le compte de service d'un utilisateur s'il existe ou en crée un. La valeur par défaut est false.
--job ou -j
Si spécifié, affiche les informations relatives à une tâche. La valeur par défaut est false.
--job_type
Avec l'option reservation_assignment, spécifie le type d'attribution de réservation de tâche à afficher. Spécifiez l'un des types suivants : QUERY, PIPELINE ou ML_EXTERNAL.
--model ou -m
Si spécifié, affiche les informations relatives à un modèle BigQuery ML.
--reservation
Si spécifié, affiche les informations concernant une réservation. La valeur par défaut est false.
--reservation_assignment
Si spécifié, affiche des informations sur les attributions de réservation pour un dossier, une organisation ou un projet spécifié. Si la ressource cible comporte des attributions explicites, celles-ci sont affichées. Sinon, la commande affiche toutes les attributions héritées des ressources parentes. Par exemple, un projet peut hériter des attributions de son dossier parent. Lorsque vous utilisez cette option, les options --job_type, --assignee_type et --assignee_id s'appliquent.
--schema
Si spécifié, n'affiche que le schéma de la table. La valeur par défaut est false.
--transfer_config
Si spécifié, affiche les informations relatives à une configuration de transfert. La valeur par défaut est false.
--transfer_run
Si spécifié, affiche les informations relatives à une exécution de transfert. La valeur par défaut est false.
--view
Si spécifié, affiche les informations relatives à une vue. La valeur par défaut est false.

bq update

La commande update met à jour un engagement de capacité, un ensemble de données, un modèle, une réservation, une attribution de réservation, une table, une configuration de transfert ou une vue.

Pour plus d'informations sur l'utilisation de la commande update, consultez les pages ci-dessous :

Voici les options spécifiques que la commande update utilise :

--capacity_commitment
Si spécifié, met à jour un engagement de capacité. La valeur par défaut est false. Utilisez cette option avec les options --merge, --plan, --renewal_plan, --split et --slots.
--clear_label
Supprime un libellé au format key:. Répétez cette option pour supprimer plusieurs libellés.
--dataset ou -d
Met à jour un ensemble de données. La valeur par défaut est false.
--default_kms_key
Met à jour un ensemble de données et définit la clé Cloud KMS utilisée pour chiffrer les données de la table dans un ensemble de données si aucune clé explicite n'est fournie lors de la création de la table ou de la requête.
--default_partition_expiration

Entier spécifiant le délai d'expiration par défaut en secondes pour toutes les partitions des tables partitionnées nouvellement créées dans l'ensemble de données. Aucune valeur minimale n'est définie pour cette option.

Le délai d'expiration d'une partition est défini sur la date UTC de la partition plus la valeur entière. Si cette propriété est définie, elle remplace le délai d'expiration de la table par défaut au niveau de l'ensemble de données, s'il existe. Si vous spécifiez l'option --time_partitioning_expiration lors de la création ou de la mise à jour d'une table partitionnée, le délai d'expiration des partitions défini au niveau de la table est prioritaire sur le délai d'expiration des partitions défini par défaut au niveau de l'ensemble de données. Spécifiez la valeur 0 pour supprimer un délai d'expiration existant.

--default_table_expiration

Entier qui met à jour la durée de vie par défaut en secondes des tables nouvellement créées dans un ensemble de données. Le délai d'expiration correspond à l'heure UTC actuelle plus la valeur entière. Spécifiez la valeur 0 pour supprimer le délai d'expiration existant.

--description

Met à jour la description d'un ensemble de données, d'une table, d'un modèle ou d'une vue.

--destination_reservation_id

Avec l'option --reservation_assignment, déplace une attribution de réservation existante vers la réservation spécifiée. La valeur correspond à l'identifiant de la réservation de destination. Pour en savoir plus, consultez l'article Déplacer une attribution vers une autre réservation.

--display_name

Met à jour le nom à afficher pour une configuration de transfert. La valeur par défaut est ''.

--etag

Ne met à jour les ressources que si les ETag correspondent.

--expiration

Entier qui met à jour le délai d'expiration en secondes d'une table, d'une vue ou d'un modèle. Spécifiez la valeur 0 pour supprimer le délai d'expiration.

--external_table_definition

Met à jour une table externe avec la définition de table spécifiée. Le schéma peut être un chemin d'accès à un fichier de schéma JSON local ou à une liste de définitions de colonnes séparées par des virgules au format field:data_type,field:data_type. Le format de définition du nom et du schéma de la table est le suivant : table::path_to_file ou table::schema@source_format=cloud_storage_uri.

--ignore_idle_slots

Utilisé avec l'option --reservation. Si la valeur définie est true, les tâches exécutées dans la réservation spécifiée n'utiliseront que les emplacements alloués à cette réservation. Si la valeur définie est false, les tâches de la réservation spécifiée peuvent utiliser des emplacements inactifs provenant d'autres réservations, ou des emplacements qui ne sont pas alloués à une réservation. La valeur par défaut est false. Pour en savoir plus, consultez la section Emplacements inactifs.

--merge

Avec l'option --capacity_commitment, deux engagements de capacité sont fusionnés. La valeur par défaut est false. Pour plus d'informations, consultez la section Fusionner deux engagements.

--model ou -m

Met à jour les métadonnées d'un modèle BigQuery ML.

--params ou -p

Met à jour les paramètres d'une configuration de transfert au format JSON : {"parameter":"value"}. Les paramètres varient en fonction de la source de données. Pour plus d'informations, consultez la page Présentation du service de transfert de données BigQuery.

--plan

Avec l'option --capacity_commitment, convertit un engagement de capacité en un forfait d'engagement de plus longue durée. Au choix : FLEX, MONTHLY ou ANNUAL. La valeur par défaut est ''.

--refresh_window_days

Entier spécifiant une fenêtre d'actualisation en jours pour une configuration de transfert.

--renewal_plan

Avec l'option --capacity_commitment, spécifie le forfait de renouvellement pour un engagement de capacité existant. Au choix : FLEX, MONTHLY, ANNUAL. La valeur par défaut est ''.

--reservation

Si spécifié, met à jour une réservation. La valeur par défaut est false.

--reservation_assignment

Si spécifié, met à jour une attribution de réservation. La valeur par défaut est false.

--schema

Chemin d'accès à un fichier de schéma JSON local, ou liste de définitions de colonnes séparées par des virgules au format field:data_type,field:data_type. La valeur par défaut est ''.

--set_label

Libellé à mettre à jour au format key:value. Répétez cette option pour mettre à jour plusieurs libellés.

--slots

Avec les options --capacity_commitment et --split, spécifie le nombre d'emplacements d'un engagement de capacité existant à répartir dans un nouvel engagement. Avec l'option --reservation, met à jour le nombre d'emplacements dans une réservation.

--source

Chemin d'accès à un fichier JSON local contenant une charge utile utilisée pour mettre à jour une ressource. Par exemple, cette option permet de spécifier un fichier JSON contenant une ressource d'ensemble de données avec une propriété access mise à jour. Le fichier est utilisé pour remplacer les contrôles d'accès de l'ensemble de données.

--split

Avec l'option --capacity_commitment, divise un engagement de capacité existant. La valeur par défaut est false. Pour en savoir plus, consultez la section Diviser un engagement.

--table ou -t

Si spécifié, met à jour une table. La valeur par défaut est false.

--target_dataset

Si spécifié, met à jour l'ensemble de données cible pour une configuration de transfert. La valeur par défaut est ''.

--time_partitioning_expiration

Entier mis à jour en secondes lorsqu'une partition temporelle doit être supprimée. Le délai d'expiration correspond à la date UTC de la partition plus la valeur entière. Un nombre négatif indique l'absence de délai d'expiration.

--time_partitioning_field

Met à jour le champ utilisé pour déterminer comment créer une partition temporelle. Si le partitionnement temporel est activé sans cette valeur, la table est partitionnée en fonction du temps de chargement.

--time_partitioning_type

Spécifie le type de partitionnement. Les valeurs possibles sont DAY, HOUR, MONTH ou YEAR. Vous ne pouvez pas modifier le type de partitionnement d'une table existante.

--transfer_config

Si spécifié, met à jour une configuration de transfert. La valeur par défaut est false.

--update_credentials

Si spécifié, met à jour les identifiants de la configuration de transfert. La valeur par défaut est false.

--use_legacy_sql

Si défini sur false, convertit la requête SQL d'une vue générée en ancien SQL en SQL standard. La valeur par défaut est true (utilise l'ancien SQL).

--view

Si spécifié, met à jour la requête SQL d'une vue. La valeur par défaut est ''.

--view_udf_resource

Met à jour l'URI Cloud Storage ou le chemin d'accès à un fichier de code local chargé et évalué immédiatement en tant que ressource de fonction définie par l'utilisateur dans une requête SQL d'une vue. Répétez cette option pour spécifier plusieurs fichiers.

bq wait

La commande wait permet d'attendre un certain nombre de secondes qu'une tâche se termine.

La commande wait utilise l'option globale --job_id et les options spécifiques suivantes :

integer
Valeur entière >= 0 spécifiant le temps d'attente. Cette valeur n'est pas une option. Vous indiquez l'entier sur la ligne de commande. Si vous spécifiez la valeur 0, la commande vérifie si la tâche est terminée et affiche immédiatement le résultat. Si vous ne spécifiez pas de valeur entière, la commande attend indéfiniment.
--fail_on_error
Si spécifié, quitte sur un message d'erreur si la tâche est toujours en cours d'exécution ou s'est terminée en échec. La valeur par défaut est true.
--wait_for_status

Si spécifié, attend un état particulier de la tâche avant de quitter. Les valeurs possibles sont les suivantes :

  • PENDING
  • RUNNING
  • DONE

La valeur par défaut est DONE.