amazon neptune - ユーザーガイド...amazon neptune ユーザーガイド table of contents...

Amazon Neptuneユーザーガイド

API バージョン 2017-11-29

Amazon Neptune ユーザーガイド

Amazon Neptune: ユーザーガイドCopyright © 2020 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's,in any manner that is likely to cause confusion among customers, or in any manner that disparages or discreditsAmazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may notbe affiliated with, connected to, or sponsored by Amazon.


Table of ContentsNeptune とは ..................................................................................................................................... 1最新情報 ............................................................................................................................................ 3Neptuneの概要 ................................................................................................................................. 16

グラフデータベースとは ............................................................................................................ 17グラフデータベースの使用例 .............................................................................................. 18グラフクエリおよびトラバーサル ........................................................................................ 20

標準コンプライアンス ............................................................................................................... 23Gremlin の標準コンプライアンス ........................................................................................ 23SPARQL の標準コンプライアンス ....................................................................................... 32

グラフデータモデル .................................................................................................................. 37インデックス作成戦略 ....................................................................................................... 37グレムリンデータモデル .................................................................................................... 39

トランザクションセマンティクス ................................................................................................ 40分離レベル ....................................................................................................................... 40Neptune の分離レベル ....................................................................................................... 41トランザクションの例 ....................................................................................................... 43例外と再試行 .................................................................................................................... 45

クラスターとインスタンス ......................................................................................................... 47プライマリ DB インスタンス .............................................................................................. 47リードレプリカのインスタンス ........................................................................................... 47インスタンスのサイズ設定 ................................................................................................. 48インスタンスのモニタリング .............................................................................................. 49

信頼性と可用性 ......................................................................................................................... 50自動修復 .......................................................................................................................... 50請求 ................................................................................................................................ 50

エンドポイント接続 .................................................................................................................. 51エンドポイントに関する考慮事項 ........................................................................................ 53カスタムエンドポイント .................................................................................................... 54カスタムエンドポイントの作成 ........................................................................................... 54カスタムエンドポイントの表示 ........................................................................................... 55カスタムエンドポイントの編集 ........................................................................................... 55カスタムエンドポイントの削除 ........................................................................................... 55

カスタム queryId ...................................................................................................................... 56HTTP ヘッダーを使用する ................................................................................................. 56SPARQL クエリヒントを使用する ....................................................................................... 56queryId を使用してステータスを確認する ............................................................................. 56

ラボモード ............................................................................................................................... 58ラボモードの使用 ............................................................................................................ 58DFE エンジン .................................................................................................................. 58OSGP インデックス .......................................................................................................... 59Streams ........................................................................................................................... 59トランザクションセマンティクス ........................................................................................ 59

Neptune DFEエンジン ............................................................................................................... 60DFEの有効化/無効化 .......................................................................................................... 60DFEによって実行されるクエリ ........................................................................................... 61DFE統計 .......................................................................................................................... 61

Neptune エンジンの更新 ............................................................................................................ 66アップグレード ................................................................................................................. 66アップグレード前のテスト ................................................................................................. 67エンジンバージョン番号 .................................................................................................... 67コンソールを使用した手動アップグレード ............................................................................ 68コンソールを使用した自動アップグレード ............................................................................ 68CLI を使用した手動更新 ..................................................................................................... 68CLI を使用した自動更新 ..................................................................................................... 69

API バージョン 2017-11-29iii


セキュリティ .................................................................................................................................... 70データ保護 ............................................................................................................................... 70

DB クラスターへの VPC アクセス ...................................................................................... 71転送時の暗号化 ................................................................................................................. 74保管時の暗号化 ................................................................................................................. 75

Identity and Access Management (IAM) ....................................................................................... 78IAM の概要 ...................................................................................................................... 80IAM 認証の有効化 ............................................................................................................. 83IAM ポリシー ................................................................................................................... 83タグベースのアクセスコントロール ..................................................................................... 89Neptune のサービスにリンクされたロール .......................................................................... 104一時認証情報 .................................................................................................................. 108接続と署名 ..................................................................................................................... 113

ログ記録とモニタリング ........................................................................................................... 130コンプライアンス検証 .............................................................................................................. 130弾力 ...................................................................................................................................... 131

ご利用開始にあたって ...................................................................................................................... 132VPC 内の DNS ....................................................................................................................... 132DB クラスターの作成 .............................................................................................................. 132

前提条件 ........................................................................................................................ 133クラスターを作成する ...................................................................................................... 135

グラフへのアクセス ................................................................................................................. 136Amazon EC2 接続 ........................................................................................................... 136curl をセットアップする ................................................................................................... 137クエリ言語 ..................................................................................................................... 137

IAM 認証 ................................................................................................................................ 138Neptune ワークベンチの使用 .................................................................................................... 138

ノートブックの作成 ......................................................................................................... 139Workbench のマジック .................................................................................................... 140開始方法ノートブック ...................................................................................................... 144グラフ可視化 .................................................................................................................. 144

Gremlin の使用 ....................................................................................................................... 146RDF/SPARQL の使用 .............................................................................................................. 149データのロード ...................................................................................................................... 150Neptune のセキュリティ .......................................................................................................... 150Neptune のモニタリング .......................................................................................................... 151Lambda 関数の作成 ................................................................................................................. 152トラブルシューティングとベストプラクティス ............................................................................ 153

Neptune への移行 ........................................................................................................................... 155TinkerPop からの移行 .............................................................................................................. 156RDF からの移行 ...................................................................................................................... 157を使用したの移行AWS DMS .................................................................................................... 158Neo4j からの移行 .................................................................................................................... 159Blazegraph からの移行 ............................................................................................................ 160

Neptune の互換性 ........................................................................................................... 160インフラストラクチャのプロビジョニング .......................................................................... 160データのエクスポート ...................................................................................................... 161Amazon S3バケットを作成する ......................................................................................... 163データをインポートする ................................................................................................... 163

Neptune データのロード .................................................................................................................. 165Neptune のバルクローダー ....................................................................................................... 165

IAM ロールと Amazon S3 アクセス ................................................................................... 166データ形式 ..................................................................................................................... 169ロードの例 ..................................................................................................................... 175一括ロードの最適化 ......................................................................................................... 179ローダーリファレンス ..................................................................................................... 180

DMS を使用したデータのロード ................................................................................................ 196

API バージョン 2017-11-29iv


GraphMappingConfig ....................................................................................................... 196Neptune へのレプリケート ............................................................................................... 199

クエリ ........................................................................................................................................... 203Gremlin .................................................................................................................................. 203

Gremlin コンソールのインストール .................................................................................... 204HTTPS REST ................................................................................................................. 206Java 。 .......................................................................................................................... 208Python ........................................................................................................................... 212.NET ............................................................................................................................. 213Node.js 、 () ................................................................................................................... 215クエリヒント .................................................................................................................. 216クエリのステータス ......................................................................................................... 220クエリのキャンセル ......................................................................................................... 222グレムリンセッション ...................................................................................................... 223Gremlin API を使用する ................................................................................................... 224グレムリン explain ....................................................................................................... 224

SPARQL ................................................................................................................................ 257RDF4J コンソール .......................................................................................................... 258RDF4J Workbench .......................................................................................................... 260Java 。 .......................................................................................................................... 261HTTP API ...................................................................................................................... 264クエリヒント .................................................................................................................. 270クエリのステータス ......................................................................................................... 278クエリのキャンセル ......................................................................................................... 280SPARQL(スパー) explain ............................................................................................... 281SPARQL(スパー) SERVICE 内線番号 ................................................................................. 302

クエリキューイング ................................................................................................................. 303キュー内のクエリ数を調べる ............................................................................................. 304クエリのタイムアウト ...................................................................................................... 304

Neptune の管理 .............................................................................................................................. 305DB パラメータグループ ........................................................................................................... 305

使用可能なパラメータ ...................................................................................................... 306パラメータグループを編集する ......................................................................................... 307パラメータグループを作成する ......................................................................................... 307

クラスターを起動する .............................................................................................................. 307クラスターの停止と開始 ........................................................................................................... 311

停止と開始の概要 ............................................................................................................ 311クラスターの停止 ............................................................................................................ 312DB クラスターの開始 ...................................................................................................... 313

レプリカの作成 ....................................................................................................................... 313DB クラスターの変更 .............................................................................................................. 314

インスタンスを変更する ................................................................................................... 315Neptune レプリカの追加 .......................................................................................................... 316パフォーマンスとスケーリング ................................................................................................. 317

ストレージのスケーリング ................................................................................................ 317インスタンススケーリング; ............................................................................................... 318読み込みのスケーリング ................................................................................................... 318

DB クラスターのメンテナンス .................................................................................................. 318メンテナンスウィンドウ ................................................................................................... 319

Neptune 更新 ......................................................................................................................... 320手動アップグレード ......................................................................................................... 320自動アップグレード ......................................................................................................... 320

DB クラスターのクローン作成 .................................................................................................. 321制約事項 ........................................................................................................................ 322コピーオンライトプロトコル ............................................................................................. 323ソースデータベースの削除 ................................................................................................ 324

インスタンスの管理 ................................................................................................................. 324

API バージョン 2017-11-29v


T3 バースト可能インスタンス ........................................................................................... 325インスタンスを変更する ................................................................................................... 326Neptune DB インスタンスの名前変更 ................................................................................. 328DB インスタンスを再起動する .......................................................................................... 329DB インスタンスを削除する ............................................................................................. 330

Neptune Streams ............................................................................................................................ 332Streams の使用 ....................................................................................................................... 333

Streams の有効化 ............................................................................................................ 333Streams の無効化 ............................................................................................................ 334Streams API の呼び出し .................................................................................................. 334Streams レスポンス ........................................................................................................ 335Streams の例外 ............................................................................................................... 336

ストリームレコード形式 ........................................................................................................... 337GREMLIN_JSON ............................................................................................................. 337RDF-NQUADS ................................................................................................................ 338

ストリームの例 ....................................................................................................................... 339AT_SEQUENCE_NUMBER の例 ........................................................................................ 339AFTER_SEQUENCE_NUMBER の例 .................................................................................. 340TRIM_HORIZON の例 ...................................................................................................... 340圧縮の例 ........................................................................................................................ 341

Neptune から Neptune へのレプリケーションのセットアップ ........................................................ 342リージョンの AWS CloudFormation テンプレートの選択 ....................................................... 342スタックの詳細の追加 ...................................................................................................... 343テンプレートの実行 ......................................................................................................... 345

Neptune フルテキスト検索 ............................................................................................................... 346AWS CloudFormation を使用した Neptune フルテキスト検索の有効化 ............................................ 346

リージョンでのフルテキスト検索の設定 ............................................................................. 347スタックの詳細の追加 ...................................................................................................... 348テンプレートの実行 ......................................................................................................... 345

Neptune フルテキスト検索データモデル ..................................................................................... 349SPARQL サンプルドキュメント ........................................................................................ 349Gremlin サンプルドキュメント .......................................................................................... 350

フルテキスト検索パラメータ ..................................................................................................... 351フルテキスト検索クエリの実行 ................................................................................................. 354SPARQL フルテキスト検索クエリの例 ....................................................................................... 355

match クエリ .................................................................................................................. 355プレフィックス ............................................................................................................... 355fuzzy ............................................................................................................................. 355term .............................................................................................................................. 356query_string .................................................................................................................... 356simple_query_string ......................................................................................................... 356

Gremlin フルテキスト検索クエリの例 ......................................................................................... 356ベーシック match ............................................................................................................ 357一致 .............................................................................................................................. 357fuzzy ............................................................................................................................. 357query_string fuzzy ........................................................................................................... 358query_string Regex .......................................................................................................... 358Hybrid クエリ ................................................................................................................. 358'+' と '-' .......................................................................................................................... 358query_string、'+' と '-' ...................................................................................................... 359query_string、AND および OR .......................................................................................... 360term .............................................................................................................................. 360プレフィックス ............................................................................................................... 360Lucene 構文 ................................................................................................................... 361

トラブルシューティングとメトリクス ........................................................................................ 362Neptune のモニタリング .................................................................................................................. 363

インスタンスのステータス ........................................................................................................ 363

API バージョン 2017-11-29vi


CloudWatch を使用する ........................................................................................................... 364コンソールを使用する ...................................................................................................... 365AWS CLI を使用する ....................................................................................................... 365CloudWatch API の使用 ................................................................................................... 366Neptune メトリックス ..................................................................................................... 366Neptune のディメンション ............................................................................................... 371

Neptune による監査ログ .......................................................................................................... 372監査ログの有効化 ............................................................................................................ 372監査ログの表示 ............................................................................................................... 372監査ログの詳細 ............................................................................................................... 373

CloudWatch Logs の Neptune ログ ............................................................................................ 373CloudWatch Logs にログを発行する (コンソール) ................................................................ 374CloudWatch Logs にログを発行する (CLI) .......................................................................... 374ログイベントをモニタリングする ...................................................................................... 374

AWS CloudTrail を使用した Neptune API 呼び出しのログ作成 ....................................................... 375CloudTrail 内の Neptune 情報 ........................................................................................... 375Neptune ログファイルエントリの概要 ................................................................................ 376

イベント通知 .......................................................................................................................... 377カテゴリとメッセージ ...................................................................................................... 378イベントへのサブスクライブ ............................................................................................. 387サブスクリプションを管理する ......................................................................................... 387

Neptune リソースのタグ付け .................................................................................................... 388タグ付けの概要 ............................................................................................................... 388コンソールでのタグ付け ................................................................................................... 390CLI を使用したタグ付け ................................................................................................... 391API を使用したタグ付け ................................................................................................... 391ARNs の使用 .................................................................................................................. 392

バックアップと復元 ......................................................................................................................... 396バックアップおよび復元の概要 ................................................................................................. 397

耐障害性 ........................................................................................................................ 397バックアップ .................................................................................................................. 398バックアップメトリクス ................................................................................................... 398データの復元 .................................................................................................................. 399バックアップウィンドウ ................................................................................................... 400

スナップショットの作成 ........................................................................................................... 401コンソールを使用する ...................................................................................................... 401

スナップショットからの復元 ..................................................................................................... 402パラメータグループ ......................................................................................................... 402セキュリティグループ ...................................................................................................... 402Neptune ......................................................................................................................... 402復元 .............................................................................................................................. 403

スナップショットのコピー ........................................................................................................ 404制約事項 ........................................................................................................................ 404スナップショットのコピーの保持 ...................................................................................... 404暗号化 ........................................................................................................................... 405クロスリージョンのスナップショットコピー ....................................................................... 405コンソールでのスナップショットのコピー .......................................................................... 405AWS CLI によるスナップショットのコピー ........................................................................ 406

スナップショットの共有 ........................................................................................................... 409暗号化されたスナップショット ......................................................................................... 409共有 .............................................................................................................................. 411

スナップショットの削除 ........................................................................................................... 413コンソールを使用する ...................................................................................................... 413AWS CLI の使用 ............................................................................................................. 413Neptune API の使用 ........................................................................................................ 413

ベストプラクティス ......................................................................................................................... 414基本的な運用についてのガイドライン ........................................................................................ 415

API バージョン 2017-11-29vii


Security ......................................................................................................................... 416Distinct 述語を制限する .................................................................................................... 416メトリクスの使用 ............................................................................................................ 416クエリのチューニング ...................................................................................................... 417ロードバランシング ......................................................................................................... 417一時インスタンスを使用する ............................................................................................. 417インスタンスのサイズ変更 ................................................................................................ 418異なるインスタンスサイズを回避する ................................................................................ 418タスク中断エラー ............................................................................................................ 418

Gremlin (一般) ........................................................................................................................ 419GLV実行差異 .................................................................................................................. 419マルチスレッド化された書き込み ...................................................................................... 419レコードの削除 ............................................................................................................... 420datetime( ) ................................................................................................................ 420ネイティブの日時 ............................................................................................................ 421

Gremlin (Java クライアント) .................................................................................................... 422最新バージョンを使用する ................................................................................................ 422クライアントオブジェクトを再利用する ............................................................................. 423読み書き用のさまざまなクライアント ................................................................................ 423複数のレプリカのエンドポイント ...................................................................................... 424終了時にクライアントを閉じる ......................................................................................... 424フェイルオーバー後の新しい接続 ...................................................................................... 425設定 maxInProcess =maxSimultaneousUsage ...................................................................... 425バイトコードとしてクエリを送信する ................................................................................ 425クエリ結果を完全に消費する ............................................................................................. 426頂点とエッジを一括追加 ................................................................................................... 427JVM DNS キャッシュを無効にする .................................................................................... 427クエリごとのレベルのタイムアウト ................................................................................... 427Graphbinary のシリアル化を使用する ................................................................................. 428以前のバージョンのバグを回避する ................................................................................... 428

SPARQL ................................................................................................................................ 428すべての名前付きグラフのクエリの実行 ............................................................................. 428ロードする名前付きのグラフを指定する ............................................................................. 429FILTER vs.VALUES ......................................................................................................... 429

Neptune の制限事項 ........................................................................................................................ 431Regions ................................................................................................................................. 431インスタンスサイズ ................................................................................................................. 431アカウントあたり .................................................................................................................... 431VPC が必要 ............................................................................................................................ 432SSL が必要 ............................................................................................................................ 432アベイラビリティーゾーンおよびサブネットグループ ................................................................... 432HTTP リクエストペイロード ..................................................................................................... 432Gremlin .................................................................................................................................. 432SPARQL UPDATE LOAD ......................................................................................................... 433認証とアクセス ....................................................................................................................... 433WebSockets の制限事項 ........................................................................................................... 433プロパティとラベル ................................................................................................................. 434バルクロード .......................................................................................................................... 434

Neptune エラー .............................................................................................................................. 435エンジンエラーコード .............................................................................................................. 435

エラー形式 ..................................................................................................................... 435クエリのエラー ............................................................................................................... 435IAM エラー ..................................................................................................................... 438

API エラー ............................................................................................................................. 439ローダーエラー ....................................................................................................................... 440

エンジンリリース ............................................................................................................................ 442リリース: 1.0.4.0 (2020-10-12) .................................................................................................. 442

API バージョン 2017-11-29viii


新機能 ........................................................................................................................... 443改良点 ........................................................................................................................... 443修正された不具合 ............................................................................................................ 443サポートされているクエリ言語のバージョン ....................................................................... 444アップグレードパス ......................................................................................................... 444アップグレード ............................................................................................................... 444

リリース: 1.0.3.0 (2020-08-03) .................................................................................................. 444パッチリリース ............................................................................................................... 445新機能 ........................................................................................................................... 445改良点 ........................................................................................................................... 445修正された不具合 ............................................................................................................ 445サポートされているクエリ言語のバージョン ....................................................................... 446アップグレードパス ......................................................................................................... 446アップグレード ............................................................................................................... 446リリース: 1.0.3.0.R2 (2020-10-12) ..................................................................................... 447

リリース: 1.0.2.2 (2020-03-09) .................................................................................................. 448パッチリリース ............................................................................................................... 448改良点 ........................................................................................................................... 448修正された不具合 ............................................................................................................ 449サポートされているクエリ言語のバージョン ....................................................................... 449アップグレードパス ......................................................................................................... 449アップグレード ............................................................................................................... 449リリース: 1.0.2.2.R5 (2020-10-12) ..................................................................................... 450リリース: 1.0.2.2.R4 (2020-07-23) ..................................................................................... 452リリース: 1.0.2.2.R3 (2020-07-22) ..................................................................................... 453リリース: 1.0.2.2.R2 (2020-04-02) ..................................................................................... 453

リリース: 1.0.2.1 (2019-11-22) .................................................................................................. 454パッチリリース ............................................................................................................... 454新機能 ........................................................................................................................... 455改良点 ........................................................................................................................... 455修正された不具合 ............................................................................................................ 455サポートされているクエリ言語のバージョン ....................................................................... 456アップグレードパス ......................................................................................................... 456アップグレード ............................................................................................................... 456リリース: 1.0.2.1.R6 (2020-04-22) ..................................................................................... 456リリース: 1.0.2.1.R5 (2020-04-22) ..................................................................................... 458リリース: 1.0.2.1.R4 (2019-12-20) ..................................................................................... 458リリース: 1.0.2.1.R3 (2019-12-12) ..................................................................................... 459リリース: 1.0.2.1.R2 (2019-11-25) ..................................................................................... 460

リリース: 1.0.2.0 (2019-11-08) .................................................................................................. 461重要: このバージョンは非推奨になりました ........................................................................ 461パッチリリース ............................................................................................................... 462新機能 ........................................................................................................................... 462サポートされているクエリ言語のバージョン ....................................................................... 462アップグレードパス ......................................................................................................... 462アップグレード ............................................................................................................... 462リリース: 1.0.2.0.R3 (2020-05-05) ..................................................................................... 463リリース: 1.0.2.0.R2 (2019-11-21) ..................................................................................... 464

リリース: 1.0.1.2 (2020-06-10) .................................................................................................. 465改良点 ........................................................................................................................... 466修正された不具合 ............................................................................................................ 466サポートされているクエリ言語のバージョン ....................................................................... 466

リリース: 1.0.1.1 (2020-06-26) .................................................................................................. 466修正された不具合 ............................................................................................................ 466サポートされているクエリ言語のバージョン ....................................................................... 466

リリース: 1.0.1.0 (2019-07-02) .................................................................................................. 467Amazon Neptune 更新: 2019-10-31 (バージョン 1.0.1.0.200502.0) .......................................... 467

API バージョン 2017-11-29ix


Amazon Neptune 更新: 2019-10-15 (バージョン 1.0.1.0.200463.0) .......................................... 468Amazon Neptune 更新: 2019-09-19 (バージョン 1.0.1.0.200457.0) .......................................... 469Amazon Neptune 更新: 2019-08-13 (バージョン 1.0.1.0.200369.0) .......................................... 470Neptune リリース: 1.0.1.0.200366.0 (2019-07-26) ................................................................ 471Amazon Neptune 更新: 2019-07-02 (バージョン 1.0.1.0.200348.0) .......................................... 473以前のリリース ............................................................................................................... 473

アップグレード ....................................................................................................................... 481アップグレード前のテスト ........................................................................................................ 482エンジンバージョン番号 ........................................................................................................... 482コンソールを使用した手動アップグレード .................................................................................. 483コンソールを使用した自動アップグレード .................................................................................. 483CLI を使用した手動更新 ........................................................................................................... 484CLI を使用した自動更新 ........................................................................................................... 484

Neptune の管理 API ........................................................................................................................ 486クラスター ............................................................................................................................. 490

DBCluster ...................................................................................................................... 490DBClusterMember ........................................................................................................... 493DBClusterRole ................................................................................................................ 493ClusterPendingModifiedValues .......................................................................................... 494CreateDBCluster ............................................................................................................. 494DeleteDBCluster .............................................................................................................. 501ModifyDBCluster ............................................................................................................. 505StartDBCluster ................................................................................................................ 510StopDBCluster ................................................................................................................ 513AddRoleToDBCluster ....................................................................................................... 517RemoveRoleFromDBCluster .............................................................................................. 517FailoverDBCluster ............................................................................................................ 518PromoteReadReplicaDBCluster ......................................................................................... 522DescribeDBClusters ......................................................................................................... 525

インスタンス .......................................................................................................................... 526DBInstance ..................................................................................................................... 526DBInstanceStatusInfo ....................................................................................................... 530OrderableDBInstanceOption .............................................................................................. 530ValidDBInstanceModificationsMessage ............................................................................... 531CreateDBInstance ........................................................................................................... 532DeleteDBInstance ............................................................................................................ 541ModifyDBInstance ............................................................................................................ 546RebootDBInstance ........................................................................................................... 556DescribeDBInstances ....................................................................................................... 560DescribeOrderableDBInstanceOptions ................................................................................ 561DescribeValidDBInstanceModifications ................................................................................ 563

パラメータ ............................................................................................................................. 563パラメータ ..................................................................................................................... 564DBParameterGroup ......................................................................................................... 565DBClusterParameterGroup ................................................................................................ 565DBParameterGroupStatus ................................................................................................. 566CopyDBParameterGroup .................................................................................................. 566CopyDBClusterParameterGroup ........................................................................................ 567CreateDBParameterGroup ................................................................................................ 569CreateDBClusterParameterGroup ...................................................................................... 570DeleteDBParameterGroup ................................................................................................ 572DeleteDBClusterParameterGroup ....................................................................................... 572ModifyDBParameterGroup ................................................................................................ 573ModifyDBClusterParameterGroup ....................................................................................... 574ResetDBParameterGroup ................................................................................................. 575ResetDBClusterParameterGroup ........................................................................................ 576DescribeDBParameters .................................................................................................... 577

API バージョン 2017-11-29x


DescribeDBParameterGroups ............................................................................................ 578DescribeDBClusterParameters .......................................................................................... 579DescribeDBClusterParameterGroups .................................................................................. 580DescribeEngineDefaultParameters ..................................................................................... 581DescribeEngineDefaultClusterParameters ........................................................................... 582

Subnets ................................................................................................................................. 583サブネット ..................................................................................................................... 583DBSubnetGroup .............................................................................................................. 583CreateDBSubnetGroup ..................................................................................................... 584DeleteDBSubnetGroup ..................................................................................................... 585ModifyDBSubnetGroup ..................................................................................................... 586DescribeDBSubnetGroups ................................................................................................ 587

スナップショット .................................................................................................................... 588DBClusterSnapshot ......................................................................................................... 589DBClusterSnapshotAttribute .............................................................................................. 590DBClusterSnapshotAttributesResult .................................................................................... 591CreateDBClusterSnapshot ................................................................................................ 591DeleteDBClusterSnapshot ................................................................................................. 594CopyDBClusterSnapshot .................................................................................................. 596ModifyDBClusterSnapshotAttribute ..................................................................................... 599RestoreDBClusterFromSnapshot ........................................................................................ 601RestoreDBClusterToPointInTime ........................................................................................ 606DescribeDBClusterSnapshots ............................................................................................ 612DescribeDBClusterSnapshotAttributes ................................................................................ 614

イベント ................................................................................................................................ 615イベント ........................................................................................................................ 615EventCategoriesMap ........................................................................................................ 615EventSubscription ............................................................................................................ 616CreateEventSubscription .................................................................................................. 617DeleteEventSubscription ................................................................................................... 619ModifyEventSubscription ................................................................................................... 620DescribeEventSubscriptions .............................................................................................. 622AddSourceIdentifierToSubscription ..................................................................................... 623RemoveSourceIdentifierFromSubscription ........................................................................... 625DescribeEvents ............................................................................................................... 626DescribeEventCategories .................................................................................................. 628

その他 ................................................................................................................................... 628CloudwatchLogsExportConfiguration ................................................................................... 629DBEngineVersion ............................................................................................................ 629EngineDefaults ................................................................................................................ 630PendingMaintenanceAction ............................................................................................... 630PendingModifiedValues .................................................................................................... 631PendingCloudwatchLogsExports ........................................................................................ 632ResourcePendingMaintenanceActions ................................................................................ 632UpgradeTarget ................................................................................................................ 632Tag ............................................................................................................................... 633AddTagsToResource ....................................................................................................... 633ListTagsForResource ....................................................................................................... 634RemoveTagsFromResource .............................................................................................. 634ApplyPendingMaintenanceAction ....................................................................................... 635DescribePendingMaintenanceActions ................................................................................. 636DescribeDBEngineVersions ............................................................................................... 637

データ型 ................................................................................................................................ 638AvailabilityZone ............................................................................................................... 638DBSecurityGroupMembership ............................................................................................ 639DomainMembership ......................................................................................................... 639DoubleRange .................................................................................................................. 639

API バージョン 2017-11-29xi


エンドポイント ............................................................................................................... 639フィルター ..................................................................................................................... 640範囲 .............................................................................................................................. 640タイムゾーン .................................................................................................................. 640VpcSecurityGroupMembership ........................................................................................... 641

API 障害 ................................................................................................................................ 641AuthorizationAlreadyExistsFault ......................................................................................... 642AuthorizationNotFoundFault .............................................................................................. 643AuthorizationQuotaExceededFault ...................................................................................... 643CertificateNotFoundFault .................................................................................................. 643DBClusterAlreadyExistsFault ............................................................................................. 643DBClusterNotFoundFault .................................................................................................. 644DBClusterParameterGroupNotFoundFault ........................................................................... 644DBClusterQuotaExceededFault .......................................................................................... 644DBClusterRoleAlreadyExistsFault ....................................................................................... 644DBClusterRoleNotFoundFault ............................................................................................ 645DBClusterRoleQuotaExceededFault ................................................................................... 645DBClusterSnapshotAlreadyExistsFault ................................................................................ 645DBClusterSnapshotNotFoundFault ..................................................................................... 645DBInstanceAlreadyExistsFault ........................................................................................... 645DBInstanceNotFoundFault ................................................................................................ 646DBLogFileNotFoundFault .................................................................................................. 646DBParameterGroupAlreadyExistsFault ................................................................................ 646DBParameterGroupNotFoundFault ..................................................................................... 646DBParameterGroupQuotaExceededFault ............................................................................. 647DBSecurityGroupAlreadyExistsFault ................................................................................... 647DBSecurityGroupNotFoundFault ........................................................................................ 647DBSecurityGroupNotSupportedFault ................................................................................... 647DBSecurityGroupQuotaExceededFault ................................................................................ 647DBSnapshotAlreadyExistsFault .......................................................................................... 648DBSnapshotNotFoundFault ............................................................................................... 648DBSubnetGroupAlreadyExistsFault ..................................................................................... 648DBSubnetGroupDoesNotCoverEnoughAZs .......................................................................... 648DBSubnetGroupNotAllowedFault ........................................................................................ 649DBSubnetGroupNotFoundFault .......................................................................................... 649DBSubnetGroupQuotaExceededFault ................................................................................. 649DBSubnetQuotaExceededFault .......................................................................................... 649DBUpgradeDependencyFailureFault ................................................................................... 649DomainNotFoundFault ...................................................................................................... 650EventSubscriptionQuotaExceededFault ............................................................................... 650InstanceQuotaExceededFault ............................................................................................ 650InsufficientDBClusterCapacityFault ..................................................................................... 650InsufficientDBInstanceCapacityFault ................................................................................... 651InsufficientStorageClusterCapacityFault ............................................................................... 651InvalidDBClusterSnapshotStateFault ................................................................................... 651InvalidDBClusterStateFault ................................................................................................ 651InvalidDBInstanceStateFault .............................................................................................. 651InvalidDBParameterGroupStateFault .................................................................................. 652InvalidDBSecurityGroupStateFault ...................................................................................... 652InvalidDBSnapshotStateFault ............................................................................................ 652InvalidDBSubnetGroupFault .............................................................................................. 652InvalidDBSubnetGroupStateFault ....................................................................................... 653InvalidDBSubnetStateFault ................................................................................................ 653InvalidEventSubscriptionStateFault ..................................................................................... 653InvalidOptionGroupStateFault ............................................................................................ 653InvalidRestoreFault .......................................................................................................... 653InvalidSubnet .................................................................................................................. 654

API バージョン 2017-11-29xii


InvalidVPCNetworkStateFault ............................................................................................ 654KMSKeyNotAccessibleFault .............................................................................................. 654OptionGroupNotFoundFault ............................................................................................... 654PointInTimeRestoreNotEnabledFault .................................................................................. 655ProvisionedIopsNotAvailableInAZFault ................................................................................ 655ResourceNotFoundFault ................................................................................................... 655SNSInvalidTopicFault ....................................................................................................... 655SNSNoAuthorizationFault ................................................................................................. 655SNSTopicArnNotFoundFault .............................................................................................. 656SharedSnapshotQuotaExceededFault ................................................................................. 656SnapshotQuotaExceededFault ........................................................................................... 656SourceNotFoundFault ...................................................................................................... 656StorageQuotaExceededFault ............................................................................................. 657StorageTypeNotSupportedFault ......................................................................................... 657SubnetAlreadyInUse ........................................................................................................ 657SubscriptionAlreadyExistFault ............................................................................................ 657SubscriptionCategoryNotFoundFault ................................................................................... 657SubscriptionNotFoundFault ............................................................................................... 658

................................................................................................................................................... dclix

API バージョン 2017-11-29xiii


Amazon Neptune とはAmazon Neptune は、高速で信頼性の高い、完全マネージド型のグラフデータベースサービスであり、高度に接続されたデータセットを扱うアプリケーションの構築と実行が容易になります。Neptune の中核は、専用の高パフォーマンスなグラフデータベースエンジンです。このエンジンは、ミリ秒のレイテンシーを使用した数十億のリレーションシップを保存してグラフをクエリするように最適化されています。Neptune は、よく使用されるグラフクエリ言語である Apache TinkerPop Gremlin および W3C のSPARQL をサポートするため、高度に接続されたデータセットを効率よくナビゲートするクエリを構築できます。Neptune は、推奨エンジン、不正検出、知識グラフ、創薬やネットワークセキュリティなどのグラフのユースケースを可能にします。

Neptune は、リードレプリカ、ポイントインタイムリカバリ、継続的な Amazon S3 へのバックアップとアベイラビリティーゾーン間のレプリケーションを備えた高い可用性を提供します。Neptune にはデータセキュリティ機能があり、保管時および伝送中の暗号化をサポートしています。Neptune は完全マネージド型であるため、ハードウェアのプロビショニング、ソフトウェアのパッチ適用、セットアップ、設定やバックアップなどのデータベース管理タスクについて頭を悩ます必要がなくなりました。

Amazon Neptune の使用方法については、次のセクションを使用して開始することが推奨されます。

• Amazon Neptune 機能の概要 (p. 16)• Neptune の開始方法 (p. 132)

データベースの設計を開始する前に、GitHub リポジトリ (グラフデータベースを使用するための AWS リファレンスアーキテクチャ) を参照することをお勧めします。ここでは、グラフデータモデルとクエリ言語の選択内容を知らせたり、参照配置アーキテクチャの例を参照したりできます。

主なサービスコンポーネント

• プライマリ DB インスタンス – 読み書きオペレーションをサポートし、クラスターボリュームに対するすべてのデータ変更を実行します。各 Neptune DB クラスターには、グラフデータベースの内容の書き込み (つまりロードまたは変更) を担当する 1 つのプライマリ DB インスタンスがあります。

• Neptune レプリカ – プライマリ DB インスタンスと同じストレージボリュームに接続し、読み取りオペレーションのみをサポートします。各 Neptune DB クラスターは、プライマリ DB インスタンスに加えて 15 台の　Neptune レプリカインスタンスを持つことができます。これにより、Neptune レプリカを別々のアベイラビリティーゾーンに配置し、読み込みクライアントからの負荷を分散することで高可用性を実現します。

• クラスターボリューム – Neptune データはクラスターボリュームに保存されます。このボリュームは、信頼性と高可用性を重視して設計されています。クラスターボリュームは、単一の AWS リージョンにある複数のアベイラビリティーゾーンにまたがるデータのコピーで構成されます。データはアベイラビリティーゾーン間で自動的にレプリケートされるため、データ損失の可能性は非常に低く、耐久性は非常に高くなります。

オープングラフ API をサポート

Amazon Neptune では、Gremlin と SPARQL 両方に対してオープングラフ API をサポートしています。そのグラフモデルとクエリ言語両方に優れたパフォーマンスを提供します。Property Graph (PG) モデルとそのオープンソースクエリ言語である Apache TinkerPop Gremlin グラフトラバーサル言語を選択するか、または、W3C 標準のリソース記述フレームワーク (RDF) モデルとその標準 SPARQL クエリ言語を使用できます。

高い安全性

API バージョン 2017-11-291

https://github.com/aws-samples/aws-dbs-refarch-graphhttps://github.com/aws-samples/aws-dbs-refarch-graphhttps://tinkerpop.apache.org/docs/current/reference/#traversalhttps://www.w3.org/TR/sparql11-query/


Neptune では、データベースのために複数のレベルのセキュリティが用意されています。セキュリティ機能には、Amazon VPC を使用したネットワーク分離、および AWS Key Management Service (AWS KMS)で作成して管理するキーを使用した保管時の暗号化があります。暗号化された Neptune インスタンスでは、基盤となるストレージのデータが暗号化されます。さらに、同じクラスター内にある自動化バックアップ、スナップショット、レプリカも暗号化されます。

完全マネージド型

Amazon Neptune では、ハードウェアのプロビジョニング、ソフトウェアのパッチ適用、セットアップ、設定またはバックアップなどのデータベース管理タスクについて頭を悩ます必要はなくなります。

Neptune を使用すると、数十億の関係に対してミリ秒単位でクエリを実行する、洗練されたインタラクティブなグラフアプリケーションを作成できます。高度に接続されたデータの SQL クエリは複雑で、パフォーマンスの調整は困難です。Neptune では、よく使われるグラフクエリ言語である TinkerPopGremlin と SPARQL を使用して、書き込みが容易で、接続されたデータを高パフォーマンスで処理する強力なクエリを実行できます。この機能により、コードの複雑さが大幅に軽減されるため、関係を処理するアプリケーションを迅速に作成できます。

Neptune は、99.99 パーセントの可能性を提供するように設計されています。データベースワークロード用に構築された SSD ベースの仮想化ストレージレイヤーとデータベースエンジンを密に統合することにより、データベースのパフォーマンスと可用性を向上させます。Neptune ストレージは耐障害性と自己修復機能を備えています。ディスクの障害はバックグラウンドでリペアされ、データベースの可用性が損なわれることはありません。Neptune は、データベースのクラッシュを自動的に検出して再起動します。クラッシュ復旧やデータベースキャッシュの再構築は必要ありません。インスタンス全体に障害が発生した場合、Neptune は最大 15 個のリードレプリカの 1 つに自動的にフェイルオーバーします。

API バージョン 2017-11-292

https://aws.amazon.com/vpc/https://aws.amazon.com/kms/


Amazon Neptune の変更と更新以下の表は、Amazon Neptune の重要な変更点をまとめたものです。

update-history-change update-history-description update-history-date

カスタムエンドポイントが利用可能に (p. 3)

Neptune で、DB インスタンスへの接続を詳細に制御するためのカスタムエンドポイントがサポートされるようになりました。「Amazon Neptune エンドポイントへの接続」を参照してください。

October 29, 2020

イベント通知が利用可能になりました (p. 3)

Neptune で、DB クラスターをより簡単にモニタリングするために使用できるイベント通知がサポートされるようになりました。「Neptune イベント通知の使用」を参照してください。

October 29, 2020

AWS Database Migration Service(DMS) を使用した Neptune グラフの入力に関するブログ投稿 (p. 3)

AWS Database Migration Service(DMS) を使用してリレーショナルデータベースから AmazonNeptune のグラフを事前設定する – パート 4: すべてをまとめるために、Brist Smith が使用します。

October 22, 2020

AWS Database Migration Service(DMS) を使用した Neptune グラフの入力に関するブログ投稿 (p. 3)

AWS Database Migration Service(DMS) を使用してリレーショナルデータベースから AmazonNeptune のグラフを追加する– パート 3: Jack Smith による RDF モデルの設計

October 22, 2020

AWS Database Migration Service(DMS) を使用した Neptune グラフの入力に関するブログ投稿 (p

amazon neptune - ユーザーガイド...amazon neptune ユーザーガイド table of contents...

Documents