amazon neptune - ユーザーガイド...amazon neptune ユーザーガイド table of contents...
TRANSCRIPT
-
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.
-
Amazon Neptune ユーザーガイド
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
-
Amazon Neptune ユーザーガイド
セキュリティ .................................................................................................................................... 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
-
Amazon Neptune ユーザーガイド
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
-
Amazon Neptune ユーザーガイド
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
-
Amazon Neptune ユーザーガイド
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
-
Amazon Neptune ユーザーガイド
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
-
Amazon Neptune ユーザーガイド
新機能 ........................................................................................................................... 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 ユーザーガイド
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
-
Amazon Neptune ユーザーガイド
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
-
Amazon Neptune ユーザーガイド
エンドポイント ............................................................................................................... 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
-
Amazon Neptune ユーザーガイド
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 とは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/
-
Amazon Neptune ユーザーガイド
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 の変更と更新以下の表は、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