Amazon Quantum Ledger Database(QLDB)でサンプル台帳の作成と検証

2022/07/30

Quantum Ledger Database(QLDB)を触ったことなかったので、デベロッパーガイドのチュートリアルをやりました。
Amazon QLDB コンソールの使用開始方法

台帳の作成

[台帳の作成]を押下しました。

自動的に複数のAZで複数のコピーを持っているということなので、VPCやアベイラビリティゾーンを指定する必要はありませんでした。
アクセス権限と暗号化の設定のみでした。

サンプルデータのロード

[チュートリアルの開始]を押下しました。

[サンプルデータをロード]を押下して数分すると、「サンプルデータがロードされました」と表示されて完了しました。

サンプルデータは車両の所有者変更履歴のようです。

PartiQLクエリの実行

PartQLエディタでサンプルクエリを実行してみました。
車両のマスタです。アウディです。

車両登録テーブルとの結合クエリです。
OwnerにGJMmrMsneiS8zTDBTGdoseが登録されています。

select p.data from 
_ql_committed_Person AS p,
VehicleRegistration AS r
WHERE r.VIN = '1N4AL11D75C109151'
and r.Owners.PrimaryOwner.PersonId = p.metadata.id

select p.data from

_ql_committed_Person AS p,

VehicleRegistration AS r

WHERE r.VIN = '1N4AL11D75C109151'

and r.Owners.PrimaryOwner.PersonId = p.metadata.id

GJMmrMsneiS8zTDBTGdoseは_ql_committed_PersonというPersonテーブルのコミット済みビューで検索できるidのようです。
結果は、Raul Lewisさんがアウディの所有者とわかりました。

このql_committedというビューを作成する手順はサンプル作成手順にはなかったので、自動的にできているものらしい。
ということで他のテーブルにもちゃんとありました。

select * from _ql_committed_Vehicle

1 2	select * from _ql_committed_Vehicle

次のサンプルはガイドでは、l.LicenseNumberでしたが、そんなフィールドはないので多分l.LicensePlateNumberが正しそう。

SELECT * FROM Person AS p, DriversLicense AS l
WHERE p.GovId = l.LicensePlateNumber

SELECT * FROM Person AS p, DriversLicense AS l

WHERE p.GovId = l.LicensePlateNumber

台帳ドキュメントの更新

SELECT metadata.id FROM _ql_committed_Person AS p
WHERE p.data.FirstName = 'Brent' and p.data.LastName = 'Logan'

SELECT metadata.id FROM _ql_committed_Person AS p

WHERE p.data.FirstName = 'Brent' and p.data.LastName = 'Logan'

Brent Loganさんのidを調べて。
6xA6z2YUkOtBmu1pypWNWyでした。

UPDATE VehicleRegistration AS r
SET r.Owners.PrimaryOwner.PersonId = '6xA6z2YUkOtBmu1pypWNWy',
    r.City = 'Everett'
WHERE r.VIN = '1N4AL11D75C109151'

UPDATE VehicleRegistration AS r

SET r.Owners.PrimaryOwner.PersonId = '6xA6z2YUkOtBmu1pypWNWy',

r.City = 'Everett'

WHERE r.VIN = '1N4AL11D75C109151'

所有者と都市を変更しました。

select p.data.FirstName, p.data.LastName, r.City from 
_ql_committed_Person AS p,
VehicleRegistration AS r
WHERE r.VIN = '1N4AL11D75C109151'
and r.Owners.PrimaryOwner.PersonId = p.metadata.id

select p.data.FirstName, p.data.LastName, r.City from

_ql_committed_Person AS p,

VehicleRegistration AS r

WHERE r.VIN = '1N4AL11D75C109151'

and r.Owners.PrimaryOwner.PersonId = p.metadata.id

変更が確認できました。

SELECT metadata.id FROM _ql_committed_Person AS p
WHERE p.data.FirstName = 'Alexis' and p.data.LastName = 'Pena'

SELECT metadata.id FROM _ql_committed_Person AS p

WHERE p.data.FirstName = 'Alexis' and p.data.LastName = 'Pena'

次にAlexis Penaさんのidを調べました。
CxlpVdeZWIz15q9wPXGMi0でした。

FROM VehicleRegistration AS r 
WHERE r.VIN = '1N4AL11D75C109151'
INSERT INTO r.Owners.SecondaryOwners
    VALUE { 'PersonId' : 'CxlpVdeZWIz15q9wPXGMi0' }

FROM VehicleRegistration AS r

WHERE r.VIN = '1N4AL11D75C109151'

INSERT INTO r.Owners.SecondaryOwners

VALUE { 'PersonId' : 'CxlpVdeZWIz15q9wPXGMi0' }

共同所有者として追加しました。

select p.data.FirstName, p.data.LastName from 
_ql_committed_Person AS p,
VehicleRegistration AS r
WHERE r.VIN = '1N4AL11D75C109151'
and r.Owners.SecondaryOwners[0].PersonId = p.metadata.id

select p.data.FirstName, p.data.LastName from

_ql_committed_Person AS p,

VehicleRegistration AS r

WHERE r.VIN = '1N4AL11D75C109151'

and r.Owners.SecondaryOwners[0].PersonId = p.metadata.id

SecondaryOwnersが配列のようなので、確認SQLどうするんだろう？って思って素直に試したらこれでできました。
Alexis Penaさんが共同所有者になったことが確認できました。

リビジョン履歴の表示

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

SELECT r_id FROM VehicleRegistration AS r BY r_id

WHERE r.VIN = '1N4AL11D75C109151'

ドキュメントのID(5EhcY0X2q4c9VD6gAUjxK1)を取得しました。
BY r_idとすると取得できるようです。
「コミット済みビューにクエリを実行する以外に、ドキュメントidを取得する方法として」と書いていたので、コミット済みビューも確認してみます。

SELECT v.metadata.id FROM _ql_committed_VehicleRegistration as v
WHERE v.data.VIN = '1N4AL11D75C109151'

SELECT v.metadata.id FROM _ql_committed_VehicleRegistration as v

WHERE v.data.VIN = '1N4AL11D75C109151'

こういうことですか。なるほど。

SELECT h.data.City, 
h.data.Owners.PrimaryOwner.PersonId,
h.data.Owners.SecondaryOwners[0]
FROM history(VehicleRegistration) AS h
WHERE h.metadata.id = '5EhcY0X2q4c9VD6gAUjxK1'

SELECT h.data.City,

h.data.Owners.PrimaryOwner.PersonId,

h.data.Owners.SecondaryOwners[0]

FROM history(VehicleRegistration) AS h

WHERE h.metadata.id = '5EhcY0X2q4c9VD6gAUjxK1'

そして履歴はhistory(VehicleRegistration)で確認するのですね。

履歴が確認できました。

SELECT VALUE h.metadata
FROM history(VehicleRegistration) AS h
WHERE h.metadata.id = '5EhcY0X2q4c9VD6gAUjxK1'

SELECT VALUE h.metadata

FROM history(VehicleRegistration) AS h

WHERE h.metadata.id = '5EhcY0X2q4c9VD6gAUjxK1'

履歴のメタデータが確認できました。

台帳内ドキュメントの検証

[ダイジェストを取得]を押下しました。

SELECT r.metadata.id, r.blockAddress
FROM _ql_committed_VehicleRegistration AS r 
WHERE r.data.VIN = '1N4AL11D75C109151'

SELECT r.metadata.id, r.blockAddress

FROM _ql_committed_VehicleRegistration AS r

WHERE r.data.VIN = '1N4AL11D75C109151'

ドキュメントIdとブロックアドレスを取得しました。

台帳を選択、ドキュメントId、ブロックアドレスを入力、ダイジェストファイルのアップロードをして、[検証]を押下しました。

一致したことが検証されました。

最後までお読みいただきましてありがとうございました！

「AWS認定資格試験テキスト＆問題集　AWS認定ソリューションアーキテクト - プロフェッショナル改訂第2版」という本を書きました。

「AWS認定資格試験テキスト AWS認定クラウドプラクティショナー改訂第3版」という本を書きました。

「AWS認定資格試験テキスト　AWS認定AIプラクティショナー」という本を書きました。

「ポケットスタディ AWS認定デベロッパーアソシエイト［DVA-C02対応］」という本を書きました。

「要点整理から攻略するAWS認定ソリューションアーキテクト-アソシエイト」という本を書きました。

「AWSではじめるLinux入門ガイド」という本を書きました。

@yamamanx

開発ベンダー5年、ユーザ企業システム部門通算9年、ITインストラクター5年目でプロトタイプビルダーもやりだしたSoftware Engineerです。
質問はコメントかSNSなどからお気軽にどうぞ。
出来る限りなるべく答えます。

このブログの内容/発言の一切は個人の見解であり、所属する組織とは関係ありません。
このブログは経験したことなどの共有を目的としており、手順や結果などを保証するものではありません。
ご参考にされる際は、読者様自身のご判断にてご対応をお願いいたします。

また、勉強会やイベントのレポートは自分が気になったことをメモしたり、聞いて思ったことを書いていますので、登壇者の意見や発表内容ではありません。

- AWS AWS, qldb

: DynamoDB IAMポリシーで特定属性だけを許可する

検証記録です。対象テーブル書籍のサンプルで作ったこちらです。所属バンドの楽 …

: CloudFront用のAWS管理プレフィックスリストを使用しました

このブログでは、CloudFrontのカスタムヘッダーとALBのルーティングを組 …

: PyCharmにAWS Tool kitをインストールしてサンプルのLambda関数をデプロイして実行しました

この記事はJetBrainsIDE Advent Calendar 2018に参 …

: Amazon EMR 「Hadoop を使用してビッグデータを分析」チュートリアルをやってみました

AWS認定データアナリティクス受験準備の一環で、Amazon EMRのチュートリ …

: JAWS-UG関西「AI で人を笑わせてみよう！ハンズオン」に参加しました

AI で人を笑わせてみよう！ハンズオン灼熱の7月最終日にJAWS-UG関西のオ …

: ヤマムギ vol.24 API GatewayでREST API作成と直接DynamoDB登録のデモをしました

2週間ぶりのヤマムギ勉強会デモなのでなんだか久しぶりな気がしました。今日はポケ …

: Rocket.ChatのOutGoingWebhookからのAPI GatewayからのDynamoDB

少し前に、Rocket.ChatからOut Going Webhookを設定して …

: ブログの画像を別アカウントのS3に移動するためにIAMロールでクロスアカウントアクセス

ずっと先延ばしにしていたのですが、このブログの画像はEC2から直接配信しています …

: Organizations組織でAWS SSOを有効にする

先日AWS Control Towerで環境を作ったら、自動でAWS SSOがで …

: AWS CodeStarで静的webサイトのテンプレートプロジェクトを作成する

執筆環境の検討中です。 CodeCommitは使うつもりで、コミットしたときにE …

PREV: DynamoDB Accelerator(DAX)のサンプルアプリケーション(Python)を実行
NEXT: Amazon Timestreamのサンプルデータベースを起動しました

Amazon Quantum Ledger Database(QLDB)でサンプル台帳の作成と検証

台帳の作成

サンプルデータのロード

PartiQLクエリの実行

台帳ドキュメントの更新

リビジョン履歴の表示

台帳内ドキュメントの検証

関連記事