ラベルの削除
データセット、テーブル、ビューからラベルを削除する方法は、次の通りです。
- Google Cloud Console の使用
- SQL DDL ステートメントの使用
- bq コマンドライン ツールの
bq update
コマンドの使用 datasets.patch
またはtables.patch
API メソッドを呼び出す- クライアント ライブラリの使用
始める前に
このドキュメントの各タスクを実行するために必要な権限をユーザーに与える Identity and Access Management(IAM)のロールを付与します。タスクの実行に必要な権限(存在する場合)は、タスクの「必要な権限」セクションに記載されています。
データセット ラベルの削除
以下のセクションでは、データセット ラベルを削除するための権限と手順を説明します。
必要な権限
データセット ラベルを削除するには、次の IAM 権限が必要です。
bigquery.datasets.get
bigquery.datasets.update
事前定義された以下の各 IAM ロールには、データセット ラベルを削除するために必要な権限が含まれています。
roles/bigquery.dataOwner
roles/bigquery.admin
また、bigquery.datasets.create
権限がある場合は、作成したデータセットのラベルを削除できます。
BigQuery での IAM のロールと権限については、事前定義ロールと権限をご覧ください。
データセット ラベルの削除
データセットからラベルを削除するには、次のオプションからひとつ選んでください。
コンソール
Google Cloud コンソールで、データセットを選択します。
データセットの詳細ページで、[ラベル] の右にある鉛筆アイコンをクリックします。
[ラベルの編集] ダイアログで、次の操作を行います。
- 削除するラベルごとに、削除(X)をクリックします。
- 変更を保存するには、[更新] をクリックします。
SQL
既存のデータセットのラベルを設定するには、ALTER SCHEMA SET OPTIONS
DDL ステートメントを使用します。ラベルを設定すると、データセット内の既存のラベルが上書きされます。次の例では、データセット mydataset
のすべてのラベルを削除します。
Google Cloud コンソールで [BigQuery] ページに移動します。
クエリエディタで次のステートメントを入力します。
ALTER SCHEMA mydataset SET OPTIONS (labels = []);
[
実行] をクリックします。
クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。
bq
データセット ラベルを削除するには、clear_label
フラグを指定して bq update
コマンドを発行します。複数のラベルを削除するには、このフラグを繰り返します。
データセットがデフォルト プロジェクト以外のプロジェクトにある場合は、project_id:dataset
の形式でプロジェクト ID をデータセットに追加します。
bq update \ --clear_label key \ project_id:dataset
ここで
- key は削除するラベルのキーです。
- project_id はプロジェクト ID です。
- dataset は更新するデータセットです。
例:
department:shipping
ラベルを mydataset
から削除するには、bq update
コマンドに --clear_label
フラグを指定して入力します。mydataset
はデフォルト プロジェクトにあります。
bq update --clear_label department mydataset
department:shipping
ラベルを myotherproject
の mydataset
から削除するには、bq update
コマンドに --clear_label
フラグを指定して入力します。
bq update --clear_label department myotherproject:mydataset
複数のラベルをデータセットから削除するには、clear_label
フラグを繰り返して各ラベルのキーを指定します。たとえば、department:shipping
ラベルと cost_center:logistics
ラベルをデフォルト プロジェクトの mydataset
から削除するには、次のように入力します。
bq update \
--clear_label department \
--clear_label cost_center \
mydataset
それぞれの例で、出力は次のようになります。
Dataset 'myproject:mydataset' successfully updated.
API
既存のデータセットの特定のラベルを削除するには、datasets.patch
メソッドを呼び出し、ラベルのキー値を null
に設定してデータセット リソースの labels
プロパティを更新します。
データセットからすべてのラベルを削除するには、datasets.patch
メソッドを呼び出して labels
プロパティを削除します。
datasets.update
メソッドはデータセット リソース全体を置き換えるため、datasets.patch
メソッドの方が適切です。
Go
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Go の設定手順を完了してください。詳細については、BigQuery Go API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Java
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Java の設定手順を完了してください。詳細については、BigQuery Java API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Node.js
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Node.js の設定手順を完了してください。詳細については、BigQuery Node.js API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Python
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Python の設定手順を完了してください。詳細については、BigQuery Python API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
テーブルまたはビューのラベルの削除
テーブルまたはビューのラベルは、次の方法で削除できます。
- Google Cloud Console の使用
- SQL DDL ステートメントの使用
- bq コマンドライン ツールの
bq update
コマンドの使用 tables.patch
API メソッドを呼び出す- ビューはテーブル リソースと同様に扱われるため、
tables.patch
を使用してビューとテーブルの両方を変更します。
- ビューはテーブル リソースと同様に扱われるため、
- クライアント ライブラリの使用
必要な権限
テーブルまたはビューのラベルを削除するには、次の IAM 権限が必要です。
bigquery.tables.get
bigquery.tables.update
事前定義された以下の各 IAM ロールには、テーブルまたはビューのラベルを削除するために必要な権限が含まれています。
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
また、bigquery.datasets.create
権限がある場合は、作成したデータセット内のテーブルとビューのラベルを削除できます。
BigQuery での IAM のロールと権限については、事前定義ロールと権限をご覧ください。
テーブルまたはビューのラベルの削除
テーブルまたはビューからラベルを削除するには、次のオプションからひとつ選んでください。
コンソール
Google Cloud コンソールで、データセットを選択します。
[詳細] タブをクリックしてから、[ラベル] の右側にある鉛筆アイコンをクリックします。
[ラベルの編集] ダイアログで、次の操作を行います。
削除するラベルごとに、削除(X)をクリックします。
変更を保存するには、[更新] をクリックします。
SQL
既存のテーブルにラベルを設定するには、ALTER TABLE SET OPTIONS
DDL ステートメント、または既存のビューのラベルを設定するには、ALTER VIEW SET OPTIONS
DDL ステートメントを使用します。ラベルを設定すると、テーブルまたはビューの既存のラベルが上書きされます。次の例では、テーブル mytable
からすべてのラベルを削除します。
Google Cloud コンソールで [BigQuery] ページに移動します。
クエリエディタで次のステートメントを入力します。
ALTER TABLE mydataset.mytable SET OPTIONS (labels = []);
[
実行] をクリックします。
クエリの実行方法については、インタラクティブ クエリを実行するをご覧ください。
bq
テーブルやビューからラベルを削除するには、clear_label
フラグを指定して bq update
コマンドを発行します。複数のラベルを削除するには、このフラグを繰り返します。
テーブルまたはビューがデフォルト プロジェクト以外のプロジェクトにある場合は、project_id:dataset
の形式でプロジェクト ID をデータセットに追加します。
bq update \ --clear_label key \ project_id:dataset.table_or_view
ここで
- key は削除するラベルのキーです。
- project_id はプロジェクト ID です。
- dataset は更新するデータセットです。
- table_or_view は、更新するテーブルまたはビューの名前です。
例:
department:shipping
ラベルを mydataset.mytable
から削除するには、bq update
コマンドに --clear_label
フラグを指定して入力します。mydataset
はデフォルト プロジェクトにあります。
bq update --clear_label department mydataset.mytable
department:shipping
ラベルを myotherproject
の mydataset.myview
から削除するには、bq update
コマンドに --clear_label
フラグを指定して入力します。
bq update --clear_label department myotherproject:mydataset.myview
複数のラベルをテーブルまたはビューから削除するには、clear_label
フラグを繰り返して各ラベルのキーを指定します。たとえば、department:shipping
ラベルと cost_center:logistics
ラベルをデフォルト プロジェクトの mydataset.mytable
から削除するには、次のように入力します。
bq update \
--clear_label department \
--clear_label cost_center \
mydataset.mytable
それぞれの例で、出力は次のようになります。
Table 'myproject:mydataset.mytable' successfully updated.
API
既存のテーブルまたはビューの特定のラベルを削除するには、tables.patch
メソッドを呼び出し、ラベルのキー値を null
に設定してテーブル リソースの labels
プロパティを更新します。
テーブルまたはビューからすべてのラベルを削除するには、tables.patch
メソッドを呼び出して labels
プロパティを削除します。
ビューはテーブル リソースと同様に扱われるため、tables.patch
メソッドを使用してビューとテーブルの両方を変更できます。また、tables.update
メソッドはデータセット リソース全体を置き換えるため、tables.patch
メソッドを使用します。
Go
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Go の設定手順を完了してください。詳細については、BigQuery Go API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Java
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Java の設定手順を完了してください。詳細については、BigQuery Java API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Node.js
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Node.js の設定手順を完了してください。詳細については、BigQuery Node.js API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Python
このサンプルを試す前に、クライアント ライブラリを使用した BigQuery クイックスタートにある Python の設定手順を完了してください。詳細については、BigQuery Python API のリファレンス ドキュメントをご覧ください。
BigQuery に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
ジョブラベルの削除
現在、既存のジョブのラベルを削除することはサポートされていません。
次のステップ
- BigQuery リソースにラベルを追加する方法を学習する。
- BigQuery リソースでラベルを表示する方法を学習する。
- BigQuery リソースでラベルを更新する方法を学習する。
- ラベルを使用してリソースをフィルタする方法を学習する。
- Resource Manager ドキュメントでラベルの使用について読む。