Aurora DSQL の開始方法

[新しいデータベース接続] を選択します。

[新しいデータベース接続] ウィンドウで、[PostgreSQL] を選択します。

[接続の設定/メイン] タブで、[接続方法: ホスト] を選択し、次の情報を入力します。

1. ホスト - クラスターエンドポイントを使用します。

   データベース – postgres と入力します。

   認証 - Database Native を選択します。

   ユーザー名 - admin と入力します。

   パスワード - 認証トークンを生成します。生成されたトークンをコピーし、パスワードとして使用します。

警告が表示された場合は無視し、認証トークンを [DBeaver Password] フィールドに貼り付けます。

クラスターに接続し、SQL ステートメントの実行を開始できます。

[新しいデータソース] を選択し、[PostgreSQL] を選択します。

[データソース/全般] タブに、次の情報を入力します。

1. ホスト - クラスターエンドポイントを使用します。

   ポート - Aurora DSQL は PostgreSQL のデフォルトを使用します: 5432

   データベース - Aurora DSQL は PostgreSQL のデフォルトの postgres を使用します。

   認証 - User & Password を選択します。

   ユーザー名 - admin と入力します。

   パスワード - トークンを生成し、このフィールドに貼り付けます。

   URL - このフィールドは変更しないでください。他のフィールドに基づいて自動的に入力されます。

パスワード - 認証トークンを生成してこれを指定します。トークンジェネレーターの結果出力をコピーし、[パスワード] フィールドに貼り付けます。

クラスターに接続し、SQL ステートメントの実行を開始できます。

AWS Management Consoleにサインインし、https://console.aws.amazon.com/dsql で Aurora DSQL コンソールを開きます。

[クラスターを作成] を選択し、[シングルリージョン] を選択します。

(オプション) [クラスター設定] で、次のいずれかのオプションを選択します。

(オプション) [タグ] で、このクラスターのタグを選択または入力します。

[クラスターを作成] を選択します。

Aurora DSQL コンソールで、接続先のクラスターを選択します。

[接続] を選択します。

[エンドポイント (ホスト)] からエンドポイントをコピーします。

[認証トークン (パスワード)] セクションで、[管理者として接続] が選択されていることを確認します。

生成された認証トークンをコピーします。このトークンの有効期間は 15 分です。

オペレーティングシステムのコマンドラインで、次のコマンドを使用して psql を起動し、クラスターに接続します。your_cluster_endpoint を、先ほどコピーしたクラスターエンドポイントに置き換えます。

PGSSLMODE=require \
  psql --dbname postgres \
  --username admin \
  --host your_cluster_endpoint

パスワードの入力を求められたら、先ほどコピーした認証トークンを入力します。期限切れのトークンを使用して再接続しようとすると、接続リクエストは拒否されます。詳細については、「Amazon Aurora DSQL での認証トークンの生成」を参照してください。

[Enter] キーを押します。PostgreSQL プロンプトが表示されます。

postgres=>

アクセス拒否エラーが発生した場合は、IAM ID に dsql:DbConnectAdmin アクセス許可があることを確認してください。アクセス許可があるにもかかわらずアクセス拒否エラーが引き続き発生する場合は、「IAM をトラブルシューティングする」および「IAM ポリシーで、アクセス拒否または操作が許可されていないことを示すエラーをトラブルシューティングする方法を教えてください」を参照してください。

example という名前のスキーマを作成します。

CREATE SCHEMA example;

自動的に生成された UUID をプライマリキーとして使用する請求書テーブルを作成します。

CREATE TABLE example.invoice(
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(), 
    created timestamp, 
    purchaser int, 
    amount float);

空のテーブルを使用するセカンダリインデックスを作成します。

CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);

部門テーブルを作成します。

CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

psql \include コマンドを使用して、GitHub の aws-samples/aurora-dsql-samples リポジトリからダウンロードした department-insert-multirow.sql という名前のファイルをロードします。my-path をローカルコピーへのパスに置き換えます。

\include my-path/department-insert-multirow.sql

psql \copy コマンドを使用して、GitHub の aws-samples/aurora-dsql-samples リポジトリから、ダウンロードした invoice.csv という名前のファイルをロードします。my-path をローカルコピーへのパスに置き換えます。

\copy example.invoice(created, purchaser, amount) from my-path/invoice.csv csv

部門をクエリし、合計売上でソートします。

SELECT name, sum(amount) AS sum_amount
FROM example.department LEFT JOIN example.invoice ON department.id=invoice.purchaser
GROUP BY name
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;

次の出力例は、部門 3 の売上が最も多いことを示しています。

           name           |     sum_amount     
--------------------------+--------------------
 Example Department Three |  54061.67752854594
 Example Department Seven |  53869.65965365204
 Example Department Eight |  52199.73742066634
 Example Department One   | 52034.078869900826
 Example Department Six   |  50886.15556256385
 Example Department Two   |  50589.98422247931
 Example Department Five  | 49549.852635496005
 Example Department Four  |  49266.15578027619
(8 rows)

AWS Management Consoleにサインインし、https://console.aws.amazon.com/dsql で Aurora DSQL コンソールを開きます。

ナビゲーションペインで [Clusters] (クラスター) を選択してください。

[クラスターを作成] を選択し、[マルチリージョン] を選択します。

(オプション) [クラスター設定] で、最初のクラスターに次のいずれかのオプションを選択します。

[マルチリージョン設定] で、最初のクラスターに次のオプションを選択します。

(オプション) 最初のクラスターのタグを選択します。

最初のクラスターを作成するには、[クラスターの作成] を選択します。前のステップで ARN を入力しなかった場合、コンソールには [クラスターのセットアップは保留中です] の通知が表示されます。

[クラスターのセットアップは保留中です] の通知で、[マルチリージョンクラスターのセットアップを完了する] を選択します。このアクションにより、別のリージョンで 2 番目のクラスターの作成が開始されます。

2 番目のクラスターについて、次のいずれかのオプションを選択します。

[your-second-region でクラスターを作成する] を選択します。ここで、your-second-region は 2 番目のクラスターの場所です。コンソールが 2 番目のリージョンで開きます。

(オプション) 2 番目のクラスターのクラスター設定を選択します。例えば、AWS KMS keyを選択できます。

2 番目のクラスターを作成するには、[クラスターの作成] を選択します。

[initial-cluster-region でピアリングする] を選択します。ここで、initial-cluster-region は作成した最初のクラスターをホストするリージョンです。

プロンプトが表示されたら、[確認] を選択します。このステップで、マルチリージョンクラスターの作成を完了します。

Aurora DSQL コンソールを開き、2 番目のクラスターのリージョンを選択します。

[クラスター] を選択します。

マルチリージョンクラスター内の 2 番目のクラスターの行を選択します。

[アクション] で、[CloudShell で開く] を選択します。

[管理者として接続] を選択します。

[CloudShell の起動] を選択します。

[Run] (実行) を選択します。

「ステップ 3: Aurora DSQL でサンプル SQL コマンドを実行する」の手順に従って、サンプルスキーマを作成します。

トランザクションの例

CREATE SCHEMA example;
CREATE TABLE example.invoice(id UUID PRIMARY KEY DEFAULT gen_random_uuid(), created timestamp, purchaser int, amount float);
CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);
CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

psql copy および include コマンドを使用してサンプルデータをロードします。詳細については、「ステップ 3: Aurora DSQL でサンプル SQL コマンドを実行する」を参照してください。

\copy example.invoice(created, purchaser, amount) from samples/invoice.csv csv
\include samples/department-insert-multirow.sql

Aurora DSQL コンソールで、最初のクラスターのリージョンを選択します。

[クラスター] を選択します。

マルチリージョンクラスター内の 2 番目のクラスターの行を選択します。

[アクション] で、[CloudShell で開く] を選択します。

[管理者として接続] を選択します。

[CloudShell の起動] を選択します。

[Run] (実行) を選択します。

2 番目のクラスターに挿入したデータをクエリします。

SELECT name, sum(amount) AS sum_amount
FROM example.department 
LEFT JOIN example.invoice ON department.id=invoice.purchaser 
GROUP BY name 
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;