Oracle Database API for MongoDBの使用
Oracle Database API for MongoDBでは、MongoDB言語ドライバおよびツールを使用してOracle Autonomous Databaseに接続できます。
Oracle Database API for MongoDBは、Autonomous Databaseのコンバージド・データベース機能を利用して、単一のデータベース内でJSONデータを含む複数のデータ型を管理します。たとえば、これらのコンバージド・データベース機能により、SQLを使用してJSONデータを問合せまたは更新できます。
MongoDBでは、ACLを使用するようにネットワーク・アクセスを構成するか、Autonomous Databaseインスタンスのプライベート・エンドポイントを定義する必要があります。
詳細は、Oracle Database API for MongoDBを参照してください。
詳細は、Autonomous JSON Databaseについてを参照してください。
詳細は、Autonomous Databaseワークロード・タイプについてを参照してください。
トピック
- MongoDBのアクセスの構成およびMongoDBの有効化
Oracle Database API for MongoDBを使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。 - MongoDBのユーザー管理
Oracle Database API for MongoDBを使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。この目的のために既存のAutonomous Databaseを使用する必要がある場合、ワークフローは次のとおりです。 - MongoDBのテストAutonomous Databaseユーザーの作成
- Autonomous DatabaseへのMongoDBアプリケーションの接続
Autonomous DatabaseへのMongoDBアプリケーションの接続には、要件に応じていくつかのステップが含まれます。
親トピック: 開発
MongoDBのアクセスの構成およびMongoDBの有効化
Oracle Database API for MongoDBを使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。
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を使用するには、ACLを構成するか、プライベート・エンドポイントを定義することで、新しいAutonomous Databaseを作成および構成したり、既存のAutonomous Databaseの構成を変更できます。
MongoDB用の新しいAutonomous Databaseの構成
ネットワーク・アクセス・タイプを選択する時点まで、Autonomous Databaseのプロビジョニングまたはクローニングのステップに従います。
この時点で、Oracle Database API for MongoDBを使用するには、次のいずれかのネットワーク・アクセス・タイプを選択して構成することで、セキュア・アクセスを構成します。
-
許可されたIPおよびVCN限定のセキュア・アクセス
-
プライベート・エンドポイント・アクセスのみ
プライベート・エンドポイントを使用したAutonomous Databaseインスタンスの構成の詳細は、プライベート・エンドポイントを使用したネットワーク・アクセスの構成を参照してください。
MongoDB用の既存のAutonomous Databaseの構成
Autonomous DatabaseインスタンスのOracle Cloud Infrastructure Consoleを開きます。
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を使用すると、Oracle Autonomous Databaseをデータ・ストアとして使用できます。この目的のために既存の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接続文字列の取得
Oracle Cloud Infrastructure ConsoleからMongoDB API接続文字列を取得できます。 - コマンドラインを使用した接続のテスト
- Node.jsアプリケーションを使用した接続のテスト
Autonomous Database MongoDB接続文字列の取得
MongoDB API接続文字列を取得したら、コマンドライン・ユーティリティであるMongoDBシェルを使用して、データを接続して問い合せることができます。
まず、ネットワーク・アクセスを構成し、MongoDB APIを有効にする必要があります。詳細は、MongoDBのアクセスの構成を参照してください。
MongoDB API接続文字列を取得するには:
- Autonomous Databaseの詳細ページで、「ツール構成」タブを選択します。
- MongoDB API行の「アクセスURL」で、「コピー」をクリックします。