機械翻訳について

「MongoDBのOracle Database API」の使用

「MongoDBのOracle Database API」では、MongoDB言語ドライバおよびツールを使用してOracle Autonomous Databaseに接続できます。

「MongoDBのOracle Database API」は、Autonomous Databaseの統合データベース機能を利用して、単一のデータベース内でJSONデータなどの複数のデータ型を管理します。 たとえば、これらの統合データベース機能を使用すると、SQLを使用してJSONデータの問合せまたは更新を行うことができます。

ノート:

MongoDBでは、ACLを使用するようにネットワーク・アクセスを構成するか、Autonomous Databaseインスタンスのプライベート・エンドポイントを定義する必要があります。

詳細については、「MongoDBのOracle Database API」を参照してください。

詳細は、Autonomous JSON Databaseに関する項を参照してください。

詳細については、「Autonomous Databaseワークロード・タイプについて」を参照してください。

トピック

• MongoDBのアクセスの構成およびMongoDBの有効化
  「MongoDBのOracle Database API」を使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。
• MongoDBのユーザー管理
  「MongoDBのOracle Database API」を使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。 この目的で既存のAutonomous Databaseを使用する必要がある場合、ワークフローを次に示します。
• MongoDBのテストAutonomous Databaseユーザーの作成
  
• MongoDBアプリケーションをAutonomous Databaseに接続
  MongoDBアプリケーションをAutonomous Databaseに接続するには、要件に応じていくつかのステップが含まれます。

MongoDBのアクセスの構成およびMongoDBの有効化

「MongoDBのOracle Database API」を使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。

MongoDB APIを使用するには、新しいAutonomous Databaseを作成および構成するか、既存のAutonomous Databaseの構成を変更できます。

ノート:

MongoDBでは、ACLを使用するようにネットワーク・アクセスを構成するか、Autonomous Databaseインスタンスのプライベート・エンドポイントを定義する必要があります。 ネットワーク・アクセスの構成に加えて、Autonomous DatabaseインスタンスでMongoDB APIを有効にする必要があります。

• MongoDBのアクセスの構成
  MongoDB APIを使用するには、ACLを構成するかプライベート・エンドポイントを定義することで、新しいAutonomous Databaseを作成および構成するか、既存のAutonomous Databaseの構成を変更できます。
• Autonomous DatabaseでMongoDB APIの有効化
  Autonomous Databaseインスタンスのネットワーク・アクセスを構成したら、MongDB APIを有効にします。

MongoDBのアクセスの構成

MongoDB APIを使用するには、ACLを構成するかプライベート・エンドポイントを定義することで、新しいAutonomous Databaseを作成および構成するか、既存のAutonomous Databaseの構成を変更できます。

MongoDBの新しいAutonomous Databaseの構成

ネットワーク・アクセス・タイプを選択する時点まで、「Autonomous Databaseのプロビジョニングまたはクローニング」のステップに従います。

「図adb_network_access_acl_provision.pngの説明」

この時点で、「MongoDBのOracle Database API」を使用するには、次のいずれかのネットワーク・アクセス・タイプを選択して構成することで、セキュア・アクセスを構成します:

• 許可されたIPおよびVCN限定のセキュア・アクセス

• プライベート・エンドポイント・アクセスのみ

  プライベート・エンドポイントを含むAutonomous Databaseインスタンスの構成の詳細は、「プライベート・エンドポイントを使用したネットワーク・アクセスの構成」を参照してください。

MongoDBの既存のAutonomous Databaseの構成

Autonomous DatabaseインスタンスのOracle Cloud Infrastructureコンソールを開きます。

「図adb_ajd_console_details.pngの説明」

ノート:

MongoDBのOracle Database APIを使用するには、ネットワークを構成する必要があり、アクセス・タイプは次のいずれかである必要があります: 許可されたIPおよびVCNのみからのセキュア・アクセスまたはプライベート・エンドポイント・アクセスのみ。

アクセス制御リスト(ACL)設定

詳細については、「既存のAutonomous Databaseインスタンスのアクセス制御リストの構成」を参照してください。

IPアドレスのACLを構成するには、パブリックIPアドレスを取得する必要があります。 パブリックIPアドレスを表示するには、いくつかの方法があります:

• 「ネットワーク・アクセス領域の選択」で、「IPアドレスを追加」をクリックします。 これにより、IPアドレスが「値」フィールドにコピーされます。

• VPNを無効にした後、「WhatIsMyIP webサイト」を使用します。
• VPNを無効にした後、curlコマンドを使用 : curl -s https://ifconfig.me。

ノート:

パブリックIPアドレスが変更される場合があります。 パブリックIPアドレスを変更した場合は、ACLを変更する必要があります。 データベースにアクセスできない場合は、ACLを確認する必要があります。

ACLのタイプとユースケース

ACLタイプ	ユース・ケース	コメント
IPアドレス	同じパブリックIPアドレスを共有するローカル開発ノート・パソコン	簡単に開始できます。 このLANに接続されているラップトップは、データベース資格証明を使用してデータベースにアクセスできます。
CIDRブロック	ローカル開発ノート・パソコン	IPv4/32表記法の使用
カンマで区切られたIPアドレス	個別のLANに接続されたローカル開発ノート・パソコンの少数(個別のパブリックIPアドレスを持つ)	10台以上のノート・パソコンで管理するのは面倒です。
CIDRブロック	インターネットに公開されている同じサブネットに接続されたローカル開発ノート・パソコン(各ラップトップには独自のパブリックIPアドレスがあります)	CIDRブロック表記です。 詳細については、「ここで計算」を参照してください。 例: 89.84.109.0/24は、89.84.109.0から89.84.109.255までの256のIPアドレスを提供
CIDRブロック付きVCN	テスト、本番またはCI/CDパイプライン用にOCIでホストされ、独自のVCNおよびComputeインスタンスを持つ	環境タイプごとにOCIコンパートメントを割り当てます。
IPアドレスとVCNとCIDRブロックの混在	テスト環境またはCI/CDパイプラインからの接続を使用してテストAutonomous Databaseにアクセスするローカル開発ラップトップ	継続的な開発作業の共通構成オプション。

Autonomous DatabaseでMongoDB APIを有効にします

Autonomous Databaseインスタンスのネットワーク・アクセスを構成したら、MongDB APIを有効にします。

既存のインスタンスに対してMongoDB APIを有効にするには:

1. Autonomous Databaseの詳細ページで、「ツール構成」タブを選択します。
2. 「ツール構成の編集」をクリックします。
3. MongoDB API行で、「ツールの有効化」列を選択して「有効」を表示します。
4. 「適用」をクリックします。

「ライフサイクルの状態」は、MongoDBが有効になるまで更新に変更されます。

「詳細オプションの表示」を選択し、「ツール」タブを選択して、インスタンスをプロビジョニングまたはクローニングするときにMongoDB APIを有効にすることもできます。

詳細については、「Autonomous Database組込みツールの管理」を参照してください。

MongoDBのユーザー管理

「MongoDBのOracle Database API」を使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。 この目的で既存のAutonomous Databaseを使用する必要がある場合、ワークフローを次に示します。

「MongoDBのOracle Database API」では、Autonomous DatabaseオブジェクトをMongoDBオブジェクトに次のようにマッピングできます:

MongoDBオブジェクト	Oracle Autonomous Databaseオブジェクト
データベース	schema
collection	table
document	document (列内)

たとえば、次のように「MongoDBのOracle Database API」を使用してコレクションを作成できます:

  use scott;
  db.createCollection('fruit');

FRUITという名前の表がスキーマSCOTTに作成されます。

「MongoDBのOracle Database API」に接続する場合、Autonomous Databaseユーザー名とパスワードを使用して認証します。 この認証された接続は、対応するスキーマ内のコレクションにアクセスします。 このユーザーは、次の要件を満たす必要があります:

• ユーザー・スキーマはORDS対応で、Webアクセスの有効化と呼ばれることもあります。 詳細については、「ORDSデータベースAPIを有効にする基本設定」を参照してください。
• ユーザーには次のロールと権限が必要です: SODA_APP、CREATE TABLE、およびCREATE SESSION。 詳細については、「Autonomous Databaseでのユーザーのロールおよび権限の管理」を参照してください。
• ユーザーには、表領域DATAの割当て制限があります。 詳細については、「Autonomous Databaseでのユーザーの作成」を参照してください。

ノート:

Autonomous DatabaseのロールDWROLEには、これらのロールが含まれます。

ユーザーに付与されていないスキーマへのアクセスは禁止されています。 たとえば、ユーザーSCOTTは、スキーマSCOTT内のコレクションにのみアクセスできます。 例外が1つあります。 認証済ユーザーにAutonomous Database権限CREATE USER、ALTER USERおよびDROP USERがある場合、そのユーザーは任意のORDS対応スキーマにアクセスできます。

また、これらの権限を持つユーザーは、暗黙的にスキーマを作成できます。 つまり、ユーザーが存在しないデータベースにコレクションを作成すると、スキーマが自動的に作成されます。 詳細については、「MongoDBのOracle Database API」を参照してください。

MongoDBのテストAutonomous Databaseユーザーの作成

後続のステップでは、データベース・アクションを使用して、適切なロールを持つテスト・ユーザーを作成します。 また、データベース・アクションSQLまたはその他のSQLコマンドライン・ユーティリティを使用して、SQL文を直接実行することもできます。 詳細については、「Autonomous Databaseでのユーザーの作成 - クライアント・ツールによる接続」を参照してください。

1. Autonomous DatabaseのOracle Cloud Infrastructureコンソールを開きます。
2. 「データベース・アクション」を選択します。
3. データベース・アクションの起動パッドから、「管理」 > 「データベース・ユーザー」を選択します。
4. 「データベース・ユーザー」ページで「+ユーザーの作成」を選択します。
5. テスト・ユーザーの「ユーザー名」および「パスワード」を入力します。 「Webアクセス」を選択し、「表領域DATAの割当て制限」を設定します。
   
   「図database_actions_create_user_for_mongodb_use.pngの説明」
6. 「付与されたロール」タブを選択します。
7. デフォルトのロールに加えて、ユーザーのSODA_APPロールを選択して追加します。
   
   「図database_actions_grant_roles_for_mongodb_use.pngの説明」
8. 「ユーザーの作成」ボタンを選択します。

このユーザー、または同様の認証済ユーザーをテスト目的で使用できます。 詳細については、「コマンドラインを使用した接続のテスト」を参照してください。

MongoDBアプリケーションをAutonomous Databaseに接続

MongoDBアプリケーションをAutonomous Databaseに接続するには、要件に応じて複数のステップが含まれます。

トピック

• データベース・アクションからのAutonomous Database接続文字列の取得

• コマンドラインを使用した接続のテスト

• Node.jsアプリケーションを使用した接続のテスト

• Autonomous Database MongoDB接続文字列の取得
  MongoDB API接続文字列は、Oracle Cloud Infrastructureコンソールから取得できます。
• コマンドラインを使用した接続のテスト
  
• Node.jsアプリケーションを使用した接続のテスト
  

Autonomous Database MongoDB接続文字列の取得

MongoDB API接続文字列は、Oracle Cloud Infrastructureコンソールから取得できます。

MongoDB API接続文字列を取得した後、コマンドライン・ユーティリティである「MongoDBシェル」を使用して、データを接続して問い合せることができます。

まず、ネットワーク・アクセスを構成し、MongoDB APIを有効にする必要があります。 詳細については、「MongoDBのアクセスの構成」を参照してください。

MongoDB API接続文字列を取得するには:

1. Autonomous Databaseの詳細ページで、「ツール構成」タブを選択します。
2. MongoDB API行のアクセスURLで、「コピー」をクリックします。

「図adb_tools_mongo_connect_string.pngの説明」

• データベース・アクションからのAutonomous Database接続文字列の取得
  

データベース・アクションからのAutonomous Database接続文字列の取得

データの接続と問合せに使用するコマンドライン・ユーティリティである「MongoDBシェル」を使用します。

1. データベース・アクションを使用して、Autonomous Databaseインスタンスの接続文字列を取得できます。

   詳細については、「ADMINとしてのデータベース・アクションへのアクセス」を参照してください。

2. データベース・アクション起動パッドの「関連サービス」で、「MongoDBのOracle Database API」をクリックします。
3. 「MongoDBのOracle Database API」ページで、「コピー」をクリックします。

コマンドラインを使用した接続のテスト

1. テスト・ユーザーとしてログインします。 詳細については、「MongoDBのテストAutonomous Databaseユーザーの作成」を参照してください。

   $ mongosh --tls --tlsAllowInvalidCertificates 'mongodb://TESTUSER:<PASSWORD>@<database URL>.
   <OCI region>.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&loadBalanced=false'
   Current Mongosh Log ID: 614c9e2a01e3575c8c0b2ec7
   Connecting to:         mongodb://TESTUSER:<PASSWORD>@<database URL>.<OCIregion>.oraclecloudapps.com:27017/admin?
   authMechanism=PLAIN&authSource=$external&tls=true&loadBalanced=false
   Using MongoDB:                   3.6.2
   Using Mongosh:                   1.0.7
   For mongosh info see: https://docs.mongodb.com/mongodb-shell/admin
   > show dbs
   testuser    0 B
   > 

   ノート:

   接続文字列URIの任意の予約文字を置換するには、URIパーセント・エンコーディングを使用 - 特に、ユーザー名とパスワードの文字。 予約文字とそのパーセント・エンコーディングは次のとおりです:

   !	#	$	%	&	'	(	)	*	+
   %21	%23	%24	%25	%26	%27	%28	%29	%2A	%2B

   ,	/	:	;	=	?	@	[	]
   %2C	%2F	%3A	%3B	%3D	%3F	%40	%5B	%5D

   たとえば、ユーザー名がRUTHで、パスワードが@least1/2#?の場合、サーバー<server>へのMongoDB接続文字列は次のようになります:

   'mongodb://RUTH:%40least1%2F2%23%3F@<server>:27017/ruth/ ...'

   使用するツールまたはドライバによっては、URI接続文字列の一部としてではなく、別のパラメータとしてユーザー名とパスワードを指定できる場合があります。 その場合、含まれている予約文字をエンコードする必要はありません。

   関連項目:

   • パーセント・エンコーディング - 予約文字

   • Uniform Resource Identifier (URI): 汎用構文

2. コレクションを作成し、ドキュメントをコレクションに挿入します。

   testuser> show collections
   
   testuser> db.createCollection( 'fruit' )
   { ok: 1 }
   testuser> show collections
   fruit
   testuser> db.fruit.insertOne( {name:"orange", count:42} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca31fdab254f63e4c6b47")
   }
   testuser> db.fruit.insertOne( {name:"apple", count:12, color: "red"} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca340dab254f63e4c6b48")
   }
   testuser> db.fruit.insertOne( {name:"pear", count:5} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca351dab254f63e4c6b49")
   }
   testuser>

3. データベース・アクションなどのSQLクライアントを使用してコレクションを問い合せます。

   SELECT
        f.json_document.name, 
        f.json_document.count, 
        f.json_document.color
   FROM fruit f;

Node.jsアプリケーションを使用した接続のテスト

1. Node.jsをダウンロードします。 環境用にNode.jsをすでにダウンロードまたはインストールしている場合は、このステップをスキップできます。

   $ wget https://nodejs.org/dist/latest-v14.x/node-v14.17.5-linux-x64.tar.xz

2. Node、jsアーカイブの内容を抽出します。 環境用にNode.jsをすでにダウンロードまたはインストールしている場合は、このステップをスキップできます。

   $ tar -xf node-v14.17.5-linux-x64.tar.xz

3. PATH環境変数を構成します。 環境用にNode.jsをすでにダウンロードまたはインストールしている場合は、このステップをスキップできます。

   $ export PATH="`pwd`"/node-v14.17.5-linux-x64/bin:$PATH

4. Javascriptの例で接続をテストします。
   1. 新規ディレクトリを作成

      $ mkdir autonomous_mongodb
      $ cd autonomous_mongodb
      $ npm init –y

   2. mongodb依存関係をインストールします。

      $ npm install mongodb

   3. connect.jsという名前のJavaScriptアプリケーションを作成します。

      const { MongoClient } = require("mongodb");
      const uri =
         "mongodb://TESTUSER:<PASSWORD>@<Database URI>.<OCI region>.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&loadBalanced=false";
      
      const client = new MongoClient(uri);
      
      async function run() {
        try {
              await client.connect();
      
              const database = client.db('admin');
              const movies = database.collection('movies');
      
              // Insert a movie
              const doc = { title: 'Back to the Future', 
                            year: 1985, genres: ['Adventure', 'Comedy', 'Sci-Fi'] }
              const result = await movies.insertOne(doc);
      
              // Query for a movie that has the title 'Back to the Future' :)
              const query = { title: 'Back to the Future' };
              const movie = await movies.findOne(query);
      
              console.log(movie);
        } finally {
           // Ensures that the client will close when you finish/error
           await client.close();
        }
      }
      run().catch(console.dir);
      

      ノート:

      接続文字列URIの任意の予約文字を置換するには、URIパーセント・エンコーディングを使用 - 特に、ユーザー名とパスワードの文字。 予約文字とそのパーセント・エンコーディングは次のとおりです:

      !	#	$	%	&	'	(	)	*	+
      %21	%23	%24	%25	%26	%27	%28	%29	%2A	%2B

      ,	/	:	;	=	?	@	[	]
      %2C	%2F	%3A	%3B	%3D	%3F	%40	%5B	%5D

      たとえば、ユーザー名がRUTHで、パスワードが@least1/2#?の場合、サーバー<server>へのMongoDB接続文字列は次のようになります:

      'mongodb://RUTH:%40least1%2F2%23%3F@<server>:27017/ruth/ ...'

      使用するツールまたはドライバによっては、URI接続文字列の一部としてではなく、別のパラメータとしてユーザー名とパスワードを指定できる場合があります。 その場合、含まれている予約文字をエンコードする必要はありません。

      関連項目:

      • パーセント・エンコーディング - 予約文字

      • Uniform Resource Identifier (URI): 汎用構文

   4. 例を実行します。 出力は次のようになります。

      $ node connect
      {
        _id: new ObjectId("611e3266005202371acf27c1"),
        title: 'Back to the Future',
        year: 1985,
        genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ]
      }