PostgreSQL 言語データベースの情報スキーマ

情報スキーマは、すべての PostgreSQL データベースに共通する組み込みスキーマです。データベースのスキーマ メタデータをフェッチするために information_schema にあるテーブルで SQL クエリを実行できます。

たとえば、以下のクエリはデータベース内のすべてのユーザー定義テーブルの名前をフェッチします。

  SELECT
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema = 'public'

用途

• information_schema テーブルは SQL インターフェースを介してのみ利用できます。例:

  • executeQueryAPI
  • gcloud spanner databases execute-sql コマンド
  • Google Cloud コンソールのデータベースの [クエリ] ページ。

  他の単一読み取りメソッドは、information_schema をサポートしていません。

• information_schema に対するクエリでは、タイムスタンプ バウンド（強力、バウンド ステイルネス、正確なステイルネスの 3 種類）を使用できます。
• GoogleSQL 言語データベースを使用している場合は、GoogleSQL 言語データベースの情報スキーマをご覧ください。

PostgreSQL の information_schema との違い

PostgreSQL 言語データベースの information_schema のテーブルは、オープンソース PostgreSQL 用の information_schema のテーブルの列を含んでおり、場合によっては Spanner の列も含んでいます。これらのテーブルでは、オープンソース PostgreSQL の列が最初にオープンソース PostgreSQL データベースと同じ順番で挿入され、Spanner 用の個別の列はその後に追加されます。Google Cloud CLI で PostgreSQL 言語データベースを使用する場合は、information_schema のオープンソース PostgreSQL バージョン用に作成されたクエリを変更せずにそのまま使用できます。

PostgreSQL 言語データベースの information_schema には、他にも以下のような大きな違いがあります。

• オープンソース PostgreSQL のテーブル列の一部は使用できますが、PostgreSQL 言語データベースには入力されません。
• PostgreSQL 言語データベースでは、デフォルトのスキーマ名に public を使用します。
• 自動生成された制約名には、オープンソース PostgreSQL データベースとは異なる形式を使用します。
• PostgreSQL 言語データベースでサポートされていないオープンソース PostgreSQL 機能に関連するテーブルは使用できません。
• Spanner で使用できるがオープンソース PostgreSQL では使用できないいくつかのテーブル（database_options、index_columns、indexes、spanner_statistics など）を使用できます。

information_schema テーブルとビューでの行フィルタリング

データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システムロール（またはそのロールのメンバー）へのアクセス権が付与されているプリンシパルは、すべての information_schema テーブルとビューの行のプリンシパルを表示できます。他のプリンシパルの場合、Spanner は現在のデータベース ロールに基づいて行をフィルタします。次の各セクションのテーブルとビューの説明では、Spanner が各テーブルとビューの行をどのようにフィルタするかを示します。

PostgreSQL 言語データベースの information_schema のテーブル

information_schema 内のテーブルとビューは、オープンソース PostgreSQL の information_schema 内のテーブルとビューと互換性があります。

以降のセクションでは、PostgreSQL 言語データベースの information_schema のテーブルとビューについて説明します。

applicable_roles

この行でフィルタされたビューには、すべてのデータベース ロールに明示的に付与されているすべてのロールのメンバーシップが一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース ロールまたは現在のデータベース ロールがメンバーであるロールに付与されているロール メンバーシップのみを表示できます。

すべてのデータベース ロールがパブリック ロールのメンバーであるため、結果からパブリック ロールへの暗黙的なメンバーシップのレコードが除外されます。

change_stream_columns

この行でフィルタリングされたビューには、テーブルの列とそれらを監視する変更ストリームに関する情報が含まれています。各行は 1 つの変更ストリームと 1 つの列を表します。変更ストリームがテーブル全体を追跡している場合、そのテーブルの列はこのビューに表示されません。

データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース・ロール、現在のデータベース・ロールがメンバーとなっているロール、または public に SELECT 権限が付与されている変更ストリームの行のみを見ることができます。

change_stream_options

この行フィルタリングされたビューには、変更ストリームの構成オプションが含まれています。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース・ロール、現在のデータベース・ロールがメンバーとなっているロール、または public に SELECT 権限が付与されている変更ストリームのオプション のみを見ることができます。

change_stream_privileges

この行でフィルタされたビューには、public を含む任意のデータベース ロールのすべての変更ストリームに付与されているすべての詳細なアクセス制御権限が一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース、現在のデータベース ロールがメンバーであるロールまたは public に対する変更ストリームに付与されている権限のみを表示できます。

change_stream_tables

この行でフィルタリングされたビューには、テーブルとそれらを監視する変更ストリームに関する情報が含まれています。各行は、1 つのテーブルと 1 つの変更ストリームを表します。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース・ロール、現在のデータベース・ロールがメンバーとなっているロール、または public に SELECT 権限が付与されている変更ストリームの行のみを見ることができます。

change_stream_tables のデータには、データベース全体を追跡するテーブルと変更ストリーム間の暗黙的な関係は含まれません。

change_streams

この行でフィルタリングされたビューでは、データベースの変更ストリームをすべて列挙し、特定のテーブルまたは列に対してデータベース全体を追跡するものを示します。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース・ロール、現在のデータベース・ロールがメンバーとなっているロール、または public に SELECT 微細アクセス制御の権限が付与されている変更ストリームのみを見ることができます。

check_constraints

check_constraints ビューには、CHECK キーワードまたは NOT NULL キーワードのいずれかによって定義されたチェック制約ごとに 1 行が含まれます。

column_column_usage

このビューには、同じテーブル内の別のベース列に依存する生成された列がすべて列挙されます。

column_options

このビューには、外部キー制約の参照先のテーブル列に定義されているすべてのオプションが列挙されます。ビューには、現在のユーザーが（オーナーとして、または特権で）アクセスできる参照テーブルの列だけが含まれます。

column_privileges

この行でフィルタされたビューには、public を含む任意のデータベース ロールに付与されているすべての列に関するアクセス制御権限が一覧表示されます。IAM データベース レベルの権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース、現在のデータベース ロールがメンバーであるロールまたは public に対する列に付与されている権限のみを表示できます。

ビューには、列を含むテーブルまたはビューから列が継承する SELECT、INSERT、UPDATE の権限が含まれます。

columns

この行でフィルタリングされたビューには、データベース内のすべてのテーブル列とビュー列に関する情報が表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベースロール、現在のデータベースロールがメンバーであるロール、または public、それらに付与されたきめ細かいアクセス制御特権（または、それらを含むテーブルに付与された SELECT , INSERT または UPDATE の特権）を持つ列のみが表示されます。

constraint_column_usage

このビューには、制約で使用される列ごとに関連する 1 つの行が表示されます。

• NOT NULL キーワードで定義された PRIMARY KEY 制約と CHECK 制約の場合、ビューにこれらの列が含まれます。
• CHECK キーワードで作成された CHECK 制約の場合、ビューにチェック制約式で使用される列が含まれます。
• 外部キー制約の場合、ビューに参照先テーブルの列が含まれます。
• UNIQUE 制約の場合、ビューに KEY_COLUMN_USAGE の列が含まれます。

constraint_table_usage

このビューには、制約で使用されるテーブルごとに 1 つの行が含まれます。FOREIGN KEY 制約の場合、テーブル情報は REFERENCES 句内のテーブルに関するものです。一意の制約または主キー制約の場合、このビューによって制約が属するテーブルが識別されます。このビューに、チェック制約と null 以外の制約は含まれません。

database_options

このテーブルには、データベースに設定されているオプションが一覧表示されます。

enabled_roles

この行でフィルタされたビューには、定義されたデータベース ロールが一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システムロールへのアクセス権を付与されているプリンシパル、またはそのロールのメンバーは、すべてのデータベース ロールを表示できます。他のすべてのプリンシパルは、直接または継承によってアクセス権が付与されているデータベース ロールのみを表示できます。このビューには、public を除くすべてのシステムロールも表示されます。

index_columns

このビューには、インデックス内の列が一覧表示されます。

indexes

このビューには、スキーマ内のインデックスが列挙されます。

information_schema_catalog_name

このテーブルには、1 つの行と、データベース名を含む 1 つの列があります。

key_column_usage

このビューによって、一意キー制約、主キー制約、または外部キー制約によって参照される現在のデータベース内のすべての列が識別されます。CHECK 制約列の詳細については、check_constraints ビューをご覧ください。

parameters

この行でフィルタされたビューには、各変更ストリーム読み取り関数の引数が定義されています。各行は、1 つの変更ストリーム読み取り関数の 1 つの引数を記述します。

データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベースロール、現在のデータベースロールがメンバーであるロール、またはpublic、きめ細かいEXECUTEアクセス制御特権が付与されている変更ストリーム読み取り機能のパラメータのみを見ることができます。

placements

次の表は、データベース内のプレースメントを示しています。

placement-options

この表には、プレースメントごとに、CREATE PLACEMENT ステートメントの OPTIONS 句でプレースメントに設定されているオプションが一覧表示されます。

referential_constraints

このビューには、FOREIGN KEY 制約ごとに関連する 1 つの行が表示されます。参照しているテーブルへの書き込みアクセス権がある制約のみを確認できます。このビューでは、外部キーが制約の適用と参照操作に使用する、参照先テーブルの PRIMARY KEY 制約と UNIQUE 制約も識別されます。

role_change_stream_grants

この行でフィルタされたビューには、public を含むすべてのデータベース ロールのすべての変更ストリームに付与されている SELECT 権限が一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルには、現在のデータベース ロールの変更ロールと、現在のデータベース ロールがメンバーであるロール（public を除く）に付与されている権限のみが表示されます。

role_column_grants

この行でフィルタされたビューには、public を含む任意のデータベース ロールに付与されているすべての列に関するアクセス制御権限が一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルには、現在のデータベース ロールの変更ロールと、現在のデータベース ロールがメンバーであるロール（public を除く）の列に付与されている権限のみが表示されます。

ビューには、列が列を含むテーブルまたはビューから継承する SELECT、INSERT、UPDATE の権限が含まれています。

role_routine_grants

この行でフィルタされたビューには、public を含むすべてのデータベース ロールのすべての変更ストリーム読み取り関数に付与されている EXECUTE 権限が一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルには、現在のデータベース ロールと、現在のデータベース ロールがメンバーであるロール（public を除く）の変更ストリーム読み取り関数で付与される権限のみが表示されます。

role_table_grants

この行でフィルタされたビューには、public を含む任意のデータベース ロールに付与されているすべてのテーブルとビューに関する詳細なアクセス制御権限が一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース ロールと、現在のデータベース ロールがメンバーであるロール（public を除く）に付与されているテーブルとビューに関する権限のみを表示できます。

routine_options

この行でフィルタされたビューには、定義された変更ストリーム読み取り関数ごとに 1 つの行が表示されます。

データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベースロール、現在のデータベースロールがメンバーであるロール、またはpublic、きめ細かいEXECUTEアクセス制御特権が付与されている変更ストリーム読み取り機能のオプションのみを見ることができます。

routine_privileges

この行でフィルタされたビューには、public を含む任意のデータベース ロールに対するすべての変更ストリーム読み取り関数に付与されているすべての詳細なアクセス制御権限が一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース、現在のデータベース ロールがメンバーであるロールまたは public に対する変更ストリームに付与されている権限のみを表示できます。

routines

この行でフィルタされたビューには、データベースの変更ストリーム読み取り関数すべてが一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベースロール、現在のデータベースロールがメンバーであるロール、またはpublic、きめ細かいEXECUTEアクセス制御特権が付与されている変更ストリーム読み取り機能のみを見ることができます。

schemata

information_schema.schemata ビューには、現在のデータベースのスキーマごとに 1 行が含まれます。スキーマには、情報スキーマと public という名前のデフォルト スキーマが含まれます。

sequences

information_schema.sequences ビューには sequences メタデータが含まれます。

spanner_statistics

このテーブルには、使用可能なクエリ オプティマイザーの統計情報パッケージが一覧表示されます。

table_constraints

このビューには、現在のユーザーがアクセスできるテーブルに属するすべての制約（SELECT を除く）が含まれます。

table_privileges

この行でフィルタされたビューには、public を含む任意のデータベース ロールに付与されているすべてのテーブルとビューに関する詳細なアクセス制御権限が一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システム・ロールまたはそのロールのメンバーへのアクセス権を付与されたプリンシパルは、このビューのすべての行を表示できます。他のすべてのプリンシパルは、現在のデータベース、現在のデータベース ロールがメンバーであるロールまたは public に対するテーブルとビューに付与されている権限のみを表示できます。

tables

この行でフィルタリングされたビューには、現在のデータベース内のすべてのテーブルとビューが一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システムロールへのアクセス権を付与されているプリンシパル、またはそのロールのメンバーは、すべてのテーブルおよびビューを表示できます。他のすべてのプリンシパルは、次のいずれかの要件を満たすテーブルのみを表示できます。

• SELECT、INSERT、UPDATE、または DELETE のきめ細かいアクセス制御権限は、現在のデータベース ロールがメンバーであるロール、または publicに対するテーブルに付与されます。
• SELECT、INSERT、UPDATE のいずれかの権限が、現在のデータベース ロール、または現在のデータベース ロールがメンバーであるロール、または public に対するテーブルの任意の列に付与されます。

table_synonyms

このテーブルには、テーブルの類義語情報が一覧表示されます。

views

この行でフィルタされたビューには、現在のデータベース内のすべてのビューが一覧表示されます。データベース レベルの IAM 権限を持つプリンシパルと、spanner_info_reader システムロールへのアクセス権を付与されているプリンシパル、またはそのロールのメンバーは、すべてのビューを表示できます。他のすべてのプリンシパルは、現在のデータベースロール、現在のデータベースロールがメンバーであるロール、またはpublic、きめ細かいSELECTアクセス制御特権が付与されているビューのみを見ることができます。

例

デフォルトのスキーマでの各テーブルに関する情報を返します。

SELECT
  t.table_catalog,
  t.table_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_schema = 'public'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name

PostgreSQL 言語データベースの information_schema 内にあるすべてのテーブルとビューの名前を返します。

SELECT table_name
FROM information_schema.tables
WHERE table_schema = "information_schema"

ユーザー テーブル my_table の列に関する情報を返します。

SELECT
  t.ordinal_position,
  t.column_name,
  t.data_type,
  t.spanner_type,
  t.is_nullable
FROM
  information_schema.columns AS t
WHERE
  t.table_schema = 'public'
  AND
  t.table_name = 'my_table'
ORDER BY
  t.ordinal_position

現在のデータベースのデフォルト スキーマの各インデックスに関する情報を返します。 ```sql SELECT t.table_name, t.index_name, t.parent_table_name FROM information_schema.indexes AS t WHERE t.table_schema = 'public' AND t.index_type != 'PRIMARY_KEY' ORDER BY t.table_schema, t.table_name, t.index_name

デフォルト以外のオプションを使用するすべての列を返します。

SELECT
  t.table_name,
  t.column_name,
  t.option_type,
  t.option_value,
  t.option_name
FROM
  information_schema.column_options AS t
WHERE
  t.table_schema = 'public'
ORDER BY
  t.table_schema,
  t.table_name,
  t.column_name,
  t.option_name

現在のオプティマイザ関連のデータベース オプションを返します。

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.schema_name='public'
  AND s.option_name IN ('optimizer_version',
    'optimizer_statistics_package')

使用可能なすべての統計情報パッケージを返します。

SELECT *
FROM information_schema.spanner_statistics;

次のステップ

• データベースの問題の調査に役立つ、利用可能なイントロスペクション ツールについての学習。