Oracle Database API for MongoDBの使用
Oracle Database API for MongoDB makes it possible to connect to Oracle Autonomous Database using MongoDB language drivers and tools.
Oracle Database API for MongoDBは、Autonomous Databaseのコンバージド・データベース機能を利用して、単一のデータベース内のJSONデータを含む複数のデータ型を管理します。たとえば、これらのコンバージド・データベース機能により、SQLを使用してJSONデータを問合せまたは更新できます。
詳細は、Oracle Database API for MongoDBを参照してください。
詳細は、Autonomous JSON Databaseについてを参照してください。
詳細は、Autonomous Databaseワークロード・タイプについてを参照してください。
- Configure Access for MongoDB and Enable MongoDB
Oracle Database API for MongoDB enables you to use an Oracle Autonomous Database as the data store. - User Management for MongoDB
Oracle Database API for MongoDB enables you to use an Oracle Autonomous Database as the data store.この目的のために既存のAutonomous Databaseを使用する必要がある場合、ワークフローは次のとおりです。 - MongoDBのテストAutonomous Databaseユーザーの作成
- Autonomous DatabaseへのMongoDBアプリケーションの接続
MongoDBアプリケーションのAutonomous Databaseへの接続には、要件に応じていくつかのステップが含まれます。
親トピック: 開発
MongoDBのアクセスの構成およびMongoDBの有効化
MongoDB APIを使用するには、新しいAutonomous Databaseを作成および構成したり、既存のAutonomous Databaseの構成を変更できます。MongoDBでは、ACLを使用するようにネットワーク・アクセスを構成するか、Autonomous Databaseインスタンスのプライベート・エンドポイントを定義する必要があります。ネットワーク・アクセスの構成に加えて、Autonomous DatabaseインスタンスでMongoDB APIを有効にする必要があります。
- MongoDBのアクセスの構成
MongoDB APIを使用するには、新しいAutonomous Databaseを作成および構成するか、ACLを構成するか、プライベート・エンドポイントを定義することで、既存のAutonomous Databaseの構成を変更できます。 - Autonomous DatabaseでのMongoDB APIの有効化
Autonomous Databaseインスタンスのネットワーク・アクセスを構成したら、MongDB APIを有効にします。
MongoDBのアクセスの構成
MongoDB APIを使用するには、新しいAutonomous Databaseを作成および構成するか、ACLを構成するか、プライベート・エンドポイントを定義することで、既存のAutonomous Databaseの構成を変更できます。
MongoDB用の新しいAutonomous Databaseの構成
ネットワーク・アクセス・タイプを選択する時点まで、Autonomous Databaseのプロビジョニングまたはクローニングのステップに従います。
![adb_network_access_acl_provision.pngの説明が続きます adb_network_access_acl_provision.pngの説明が続きます](img/adb_network_access_acl_provision.png)
この時点で、Oracle Database API for MongoDBを使用するには、次のいずれかのネットワーク・アクセス・タイプを選択して構成することで、セキュア・アクセスを構成します。
-
許可されたIPおよびVCN限定のセキュア・アクセス
-
プライベート・エンドポイント・アクセスのみ
プライベート・エンドポイントを使用したAutonomous Databaseインスタンスの構成の詳細は、プライベート・エンドポイントを使用したネットワーク・アクセスの構成を参照してください。
MongoDB用の既存のAutonomous Databaseの構成
Autonomous DatabaseインスタンスのOracle Cloud Infrastructureコンソールを開きます。
![adb_ajd_console_details.pngの説明が続きます adb_ajd_console_details.pngの説明が続きます](img/adb_ajd_console_details.png)
Oracle Database API for MongoDBを使用するには、ネットワークを構成する必要があり、アクセス・タイプは次のいずれかである必要があります: 指定されたIPおよびVCNからのセキュア・アクセスを許可またはVirtual Cloud Network。
アクセス制御リスト(ACL)の設定
詳細は、既存のAutonomous Databaseインスタンスのアクセス制御リストの構成を参照してください。
-
ネットワーク・アクセスの選択領域で、「自分のIPアドレスの追加」をクリックします。これにより、IPアドレスが「値」フィールドにコピーされます。
- VPNを無効にした後、WhatIsMyIP Webサイトを使用します。
- VPNを無効にした後、カール・コマンド
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 | 独自のVCNおよびコンピュート・インスタンスを持つOCIでホストされるテスト、本番またはCI/CDパイプラインの場合 | 環境タイプごとにOCIコンパートメントを割り当てます。 |
IPアドレスとCIDRブロックを使用したVCNの混在 | テスト環境またはCI/CDパイプラインからの接続を使用してテストAutonomous Databaseにアクセスするローカル開発ノートパソコン | 進行中の開発作業のための共通構成オプションです。 |
Autonomous DatabaseでのMongoDB APIの有効化
Autonomous Databaseインスタンスのネットワーク・アクセスを構成したら、MongDB APIを有効にします。
既存のインスタンスに対してMongoDB APIを有効にするには:
- Autonomous Databaseの詳細ページで、「ツール構成」タブを選択します。
- 「ツール構成の編集」をクリックします。
- MongoDB API行で、「ツールの有効化」列で「有効」を表示するように選択します。
- 「適用」をクリックします。
「ライフサイクルの状態」は、MongoDBが有効になるまで更新に変更されます。
「拡張オプションの表示」を選択し、「ツール」タブを選択して、インスタンスをプロビジョニングまたはクローニングするときにMongoDB APIを有効にすることもできます。
詳細は、Autonomous Database組込みツールの管理を参照してください。
MongoDBのユーザー管理
Oracle Database API for MongoDB enables you to use an Oracle Autonomous Database as the data store.この目的のために既存のAutonomous Databaseを使用する必要がある場合、ワークフローは次のとおりです。
Oracle Database API for MongoDBでは、次のようにAutonomous DatabaseオブジェクトをMongoDBオブジェクトにマッピングできます:
MongoDBオブジェクト | Oracle Autonomous Databaseオブジェクト |
---|---|
データベース | スキーマ |
コレクション | 表 |
ドキュメント | ドキュメント(列内) |
たとえば、次のようにOracle Database API for MongoDBを使用してコレクションを作成できます:
use scott;
db.createCollection('fruit');
FRUITという名前の表がスキーマSCOTTに作成されます。
Oracle Database API for MongoDBに接続する場合、Autonomous Databaseのユーザー名とパスワードを使用して認証します。この認証済接続は、対応するスキーマ内のコレクションにアクセスします。このユーザーは、次の要件を満たす必要があります:
- ユーザーのスキーマはORDS対応である必要があります。これは、Webアクセスに対して有効と呼ばれることがあります。詳細は、ORDSデータベースAPIを有効化するための基本設定を参照してください。
- ユーザーには、
SODA_APP
、CREATE TABLE
およびCREATE SESSION
のロールと権限が必要です。詳細については、Manage User Roles and Privileges on Autonomous Databaseを参照してください。 - ユーザーには、表領域DATAに対する割当て制限があります。詳細は、Autonomous Databaseでのユーザーの作成に関する項を参照してください。
Autonomous Databaseのロール
DWROLE
には、これらのロールなどが含まれます。
ユーザーに付与されていないスキーマへのアクセスは禁止されています。たとえば、ユーザーSCOTTは、スキーマSCOTT内のコレクションにのみアクセスできます。例外があります。認証ユーザーにAutonomous Database権限CREATE USER
、ALTER USER
およびDROP USER
がある場合、そのユーザーは任意のORDS対応スキーマにアクセスできます。
また、これらの権限を持つユーザーは、暗黙的にスキーマを作成できます。つまり、存在しないデータベースにユーザーがコレクションを作成すると、スキーマが自動的に作成されます。詳細は、Oracle Database API for MongoDBを参照してください。
MongoDBのテストAutonomous Databaseユーザーの作成
Autonomous DatabaseへのMongoDBアプリケーションの接続
MongoDBアプリケーションをAutonomous Databaseに接続する場合、要件に応じていくつかのステップが含まれます。
- Autonomous DatabaseのMongoDB接続文字列の取得
MongoDB API接続文字列は、Oracle Cloud Infrastructureコンソールから取得できます。 - コマンドラインを使用した接続のテスト
- Node.jsアプリケーションを使用した接続のテスト
Autonomous Database MongoDB接続文字列の取得
MongoDB API接続文字列を取得したら、コマンドライン・ユーティリティであるMongoDBシェルを使用して、データを接続して問い合せることができます。
まず、ネットワーク・アクセスを構成し、MongoDB APIを有効にする必要があります。詳細は、MongoDBのアクセスの構成を参照してください。
MongoDB API接続文字列を取得するには:
- Autonomous Databaseの詳細ページで、「ツール構成」タブを選択します。
- MongoDB API行の「アクセスURL」で、「コピー」をクリックします。
![adb_tools_mongo_connect_string.pngの説明が続きます adb_tools_mongo_connect_string.pngの説明が続きます](img/adb_tools_mongo_connect_string.png)