コンソールQLDBを使用した Amazon へのアクセス

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon Ledger QLDB を Amazon Aurora Postgre に移行するSQL」を参照してください。

Amazon AWS Management Console の には、https://console.aws.amazon.com/qldb QLDBからアクセスできます。

コンソールを使用して、 で次の操作を実行できますQLDB。

• 台帳を作成、削除および列挙したり、台帳に説明を追加したりする。

• PartiQL エディタを使用して PartiQL ステートメントを実行します。

• QLDB リソースのタグを管理します。

• ジャーナルデータを暗号的に検証する。

• ジャーナルブロックをエクスポートまたはストリーミングします。

Amazon QLDB台帳を作成してサンプルアプリケーションデータで設定する方法については、「」を参照してくださいAmazon QLDBコンソールの開始方法。

PartiQL エディタのクイックリファレンス

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon Ledger QLDB を Amazon Aurora Postgre に移行するSQL」を参照してください。

Amazon は、クエリ言語として PartiQL のサブセットをサポートし、ドキュメント指向のデータ形式として Amazon Ion QLDBをサポートしています。PartiQL のQLDB実装に関する詳細なガイドと詳細については、「」を参照してくださいAmazon QLDB PartiQL リファレンス。 PartiQL

以下のトピックでは、 で PartiQL を使用する方法のクイックリファレンスの概要を示しますQLDB。

の PartiQL クイックヒント QLDB

以下は、 で PartiQL を使用する際のヒントとベストプラクティスの簡単な概要ですQLDB。

• 同時実行数とトランザクション制限を理解する – SELECTクエリを含むすべてのステートメントは、30 秒のトランザクションタイムアウトを含む、オプティミスティック同時実行制御 (OCC） の競合とトランザクション制限の対象となります。

• インデックスの使用 - 高基数インデックスを使用し、ターゲットとなるクエリを実行して、ステートメントを最適化し、すべてのテーブルスキャンを回避します。詳細については、「クエリパフォーマンスの最適化」を参照してください。

• 等価述語の使用 - インデックス付きルックアップには等価演算子 (= または IN) が必要です。不等価演算子 (<、>、LIKE、BETWEEN) はインデックス付きルックアップの対象にならず、すべてのテーブルスキャンが実行されます。

• 内部結合のみを使用する — は内部結合のみQLDBをサポートします。ベストプラクティスとして、結合するテーブルごとにインデックス付けされたフィールドで結合します。結合基準と等価述語の両方に高基数インデックスを選択します。

コマンド

QLDB は、次の PartiQL コマンドをサポートしています。

データ定義言語 (DDL）
コマンド	説明
CREATE INDEX	テーブルの最上位のドキュメントフィールドのインデックスを作成します。
CREATE TABLE	テーブルを作成します。
DROP INDEX	テーブルからインデックスを削除します。
DROP TABLE	既存のテーブルを無効にします。
UNDROP TABLE	非アクティブなテーブルを再度有効にします。

データ操作言語 (DML）
コマンド	説明
DELETE	ドキュメントの新しい最終リビジョンを作成して、アクティブなドキュメントを削除済みとしてマークします。
FROM (INSERT、REMOVE、または SET）	セマンティック的には UPDATE と同じです。
INSERT	テーブルに 1 つまたは複数のドキュメントを追加します。
SELECT	1 つまたは複数のテーブルからデータを取得します。
UPDATE	ドキュメント内の特定の要素を更新、挿入、または削除します。

DML ステートメントの例

INSERT

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidToDate' : `2020-06-25T` --Ion timestamp literal with day precision
}

UPDATE-INSERT

UPDATE Vehicle AS v
INSERT INTO v VALUE 26500 AT 'Mileage'
WHERE v.VIN = '1N4AL11D75C109151'

UPDATE-REMOVE

UPDATE Person AS p
REMOVE p.Address
WHERE p.GovId = '111-22-3333'

SELECT – 相関サブクエリ

SELECT r.VIN, o.SecondaryOwners
FROM VehicleRegistration AS r, @r.Owners AS o
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT - 内部結合

SELECT v.Make, v.Model, r.Owners
FROM VehicleRegistration AS r INNER JOIN Vehicle AS v
ON r.VIN = v.VIN
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT – BY 句を使用してドキュメント ID を取得する

SELECT r_id FROM VehicleRegistration AS r BY r_id
WHERE r.VIN = '1HVBBAANXWH544237'

システム定義ビュー

QLDB は、次のシステム定義のテーブルビューをサポートします。

ビュー	説明
table_name	ユーザーデータの現在の状態のみが含まれる、テーブルのデフォルトのユーザービュー。
_ql_committed_table_name	ユーザーデータとシステム生成メタデータ (ドキュメント ID など) の両方の現在の状態が含まれる、テーブルの完全システム定義のコミット済みビュー。
history(table_name)	テーブルのリビジョン履歴全体を返す、組み込みの履歴関数。

基本的な構文ルール

QLDB は、PartiQL の次の基本的な構文ルールをサポートしています。

文字	説明
'	一重引用符は、Amazon Ion 構造内の文字列値、またはフィールド名を表します。
"	二重引用符は、引用符で囲まれた識別子 (テーブル名として使用される予約語など) を表します。
`	バックティックは Ion リテラル値を表します。
.	ドット表記で、親構造のフィールド名にアクセスします。
[ ]	角括弧は Ion の list を定義します。または、既存のリストのゼロから始まる序数を表します。
{ }	中括弧は Ion の struct を定義します。
<< >>	二重山括弧は、順序付けられていないコレクションである PartiQL バッグを定義します。バッグを使うと、複数のドキュメントをテーブルに挿入できます。
大文字と小文字の区別	フィールド名やテーブル名を含むすべてのQLDBシステムオブジェクト名では、大文字と小文字が区別されます。

PartiQL エディタのキーボードショートカット

QLDB コンソールの PartiQL エディタは、次のキーボードショートカットをサポートしています。

アクション	macOS	Windows
実行	Cmd+Return	Ctrl+Enter
コメント	Cmd+/	Ctrl+/
Clear	Cmd+Shift+Delete	Ctrl+Shift+Delete