コンソールQLDBを使用した Amazon へのアクセス - Amazon Quantum 台帳データベース (Amazon QLDB)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

重要

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

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

コンソールを使用して、 で次の操作を実行できます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) が必要です。不等価演算子 (<>LIKEBETWEEN) はインデックス付きルックアップの対象にならず、すべてのテーブルスキャンが実行されます。

  • 内部結合のみを使用する — は内部結合のみ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