TABLE_CONSTRAINTS ビュー
TABLE_CONSTRAINTS
ビューには、BigQuery データセット内の主キーと外部キーの関係が含まれます。
必要な権限
次の Identity and Access Management(IAM)権限が必要です。
bigquery.tables.get
: 主キーと外部キーの定義を表示します。bigquery.tables.list
: テーブル情報スキーマを表示します。
次の各事前定義ロールには、このドキュメントで説明するワークフローの実行に必要な権限があります。
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
BigQuery での IAM のロールと権限について詳しくは、事前定義ロールと権限をご覧ください。
スキーマ
INFORMATION_SCHEMA.TABLE_CONSTRAINTS
ビューのスキーマは次のとおりです。
列名 | 型 | 意味 |
---|---|---|
|
|
制約プロジェクト名。 |
|
|
制約データセット名。 |
|
|
制約名。 |
|
|
制約付きテーブルのプロジェクト名。 |
|
|
制約付きテーブルのデータセット名。 |
|
|
制約付きテーブルの名前。 |
|
|
PRIMARY KEY 、FOREIGN KEY のいずれか。 |
|
|
YES または NO (制約が延期可能かどうかによる)。NO のみがサポートされています。 |
|
|
NO のみがサポートされています。 |
|
|
YES または NO (制約が適用されているかどうかによる)。NO のみがサポートされています。 |
スコープと構文
このビューに対するクエリでは、データセット修飾子を指定する必要があります。データセット修飾子が指定されたクエリの場合は、データセットに対する権限が必要です。詳細については、構文をご覧ください。次の表に、このビューのリージョン スコープとリソース スコープを示します。
ビュー名 | リソース スコープ | リージョン スコープ |
---|---|---|
[PROJECT_ID.]DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS; |
データセット レベル | データセットの場所 |
省略可: PROJECT_ID
: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
例
次のクエリは、データセット内の単一テーブルの制約を示します。
SELECT * FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE table_name = TABLE;
次のように置き換えます。
PROJECT_ID
: 省略可。クラウド プロジェクトの名前。指定しない場合、このコマンドではデフォルトのプロジェクトが使用されます。DATASET
: データセット名。TABLE
: テーブルの名前。
次のクエリは逆に、単一データセット内のすべてのテーブルの制約を示します。
SELECT * FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS;
既存の制約を使用すると、クエリ結果は次のようになります。
+-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+ | Row | constraint_catalog | constraint_schema | constraint_name | table_catalog | table_schema | table_name | constraint_type | is_deferrable | initially_deferred | enforced | +-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+ | 1 | myConstraintCatalog | myDataset | orders.pk$ | myConstraintCatalog | myDataset | orders | PRIMARY KEY | NO | NO | NO | | 2 | myConstraintCatalog | myDataset | orders.order_customer | myConstraintCatalog | myDataset | orders | FOREIGN KEY | NO | NO | NO | +-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+
テーブルまたはデータセットに制約がない場合、クエリ結果は次のようになります。
+-----------------------------+ | There is no data to display | +-----------------------------+