Amazon Aurora DSQL はプレビューサービスとして提供されています。詳細については、「AWS サービス規約」の「ベータ版とプレビュー」を参照してください。

Aurora DSQL の非同期インデックス

CREATE INDEX ASYNC コマンドは、指定されたテーブルの列にインデックスを作成します。CREATE INDEX ASYNC は非同期 DDL オペレーションであるため、このコマンドは他のトランザクションをブロックしません。

このコマンドを実行すると、Aurora DSQL はすぐに job_id を返します。非同期ジョブのステータスは、sys.jobs システムビューでいつでも確認できます。

インデックス作成ジョブが進行中の場合は、次のプロシージャとコマンドを使用できます。

Aurora DSQL が非同期インデックスタスクを完了すると、システムカタログが更新され、インデックスがアクティブであることが示されます。この時点で他のトランザクションが同じ名前空間内のオブジェクトを参照している場合、同時実行エラーが表示されることがあります。

構文

CREATE INDEX ASYNC は以下の構文を使用します。

CREATE [ UNIQUE ] INDEX ASYNC [ IF NOT EXISTS ] name ON table_name 
     ( { column_name } [ NULLS { FIRST | LAST } ] ) 
     [ INCLUDE ( column_name [, ...] ) ] 
     [ NULLS [ NOT ] DISTINCT ]

パラメータ

使用に関する注意事項

以下のガイドラインを検討します。

インデックスの作成: 例

次の例は、スキーマ、テーブル、インデックスを作成する方法を示しています。

インデックス作成のステータスのクエリ: 例

次の例に示すように、sys.jobs システムビューをクエリしてインデックスの作成ステータスを確認します。

SELECT * FROM sys.jobs

Aurora DSQL は、次のようなレスポンスを返します。

           job_id           |   status   | details 
----------------------------+------------+---------
 vs3kcl3rt5ddpk3a6xcq57cmcy | completed  | 
 ihbyw2aoirfnrdfoc4ojnlamoq | processing | 

[status] 列には、次のいずれかの値を指定することができます。

カタログテーブル pg_index および pg_class を使用して、インデックスの状態をクエリすることもできます。具体的には、属性 indisvalid と indisimmediate により、インデックスの状態を知ることができます。Aurora DSQL がインデックスを作成する間、初期ステータスは INVALID です。インデックスの indisvalid フラグは、FALSE または f を返します。これはインデックスが有効でないことを示します。フラグが TRUE または t を返すと、インデックスは準備完了です。

select relname as index_name, indisvalid as is_valid, pg_get_indexdef(indexrelid) as index_definition
from pg_index, pg_class
where pg_class.oid = indexrelid and indrelid = 'test.departments'::regclass;

    index_name    | is_valid |                                                 index_definition                                                  
------------------+----------+-------------------------------------------------------------------------------------------------------------------
 department_pkey  |     t    | CREATE UNIQUE INDEX department_pkey ON test.departments USING btree_index (title) INCLUDE (name, manager, size)
 test_index1      |     t    | CREATE INDEX test_index1 ON test.departments USING btree_index (name, manager, size)

インデックスの状態のクエリ: 例

カタログテーブル pg_index および pg_class を使用して、インデックスの状態をクエリできます。具体的には、属性 indisvalid と indisimmediate はインデックスの状態を示します。次の例は、クエリと結果のサンプルです。

SELECT relname AS index_name, indisvalid AS is_valid, pg_get_indexdef(indexrelid) AS index_definition
FROM pg_index, pg_class
WHERE pg_class.oid = indexrelid AND indrelid = 'test.departments'::regclass;

     index_name    | is_valid |                                                 index_definition                                                  
------------------+----------+-------------------------------------------------------------------------------------------------------------------
 department_pkey  |     t    | CREATE UNIQUE INDEX department_pkey ON test.departments USING btree_index (title) INCLUDE (name, manager, size)
 test_index1      |     t    | CREATE INDEX test_index1 ON test.departments USING btree_index (name, manager, size)

Aurora DSQL がインデックスを作成する間、初期ステータスは INVALID です。インデックスの indisvalid 列には、インデックスが有効でないことを示す FALSE または f が表示されます。列に TRUE または t が表示されていると、インデックスは準備完了です。

indisunique フラグは、インデックスが UNIQUE であることを示します。テーブルが同時書き込みの一意性チェックの対象であるかどうかを確認するには、以下のクエリのように、pg_index の indimmediate 列をクエリします。

SELECT relname AS index_name, indimmediate AS check_unique, pg_get_indexdef(indexrelid) AS index_definition
FROM pg_index, pg_class
WHERE pg_class.oid = indexrelid 
AND indrelid = 'test.departments'::regclass;

index_name       | check_unique | index_definition 
------------------+----------+-------------------------------------------------------------------------------------------------------------------
 department_pkey |            t | CREATE UNIQUE INDEX department_pkey ON test.departments USING btree_index (title) INCLUDE (name, manager, size)
 test_index1     |            f | CREATE INDEX test_index1 ON test.departments USING btree_index (name, manager, size)

列に f が表示され、ジョブのステータスが processing である場合、インデックスはまだ作成中です。インデックスへの書き込みは一意性チェックの対象ではありません。列に t が表示され、ジョブのステータスが processing である場合、初期インデックスは構築されていますが、インデックス内のすべての行で一意性チェックが実行されていません。ただし、インデックスへの現在および将来のすべての書き込みについて、Aurora DSQL は一意性チェックを実行します。