在專用 Exadata 基礎架構上搭配 Oracle Autonomous AI Database 使用 MongoDB API

Oracle Database API for MongoDB 會將 MongoDB 線路協定轉譯成由 Oracle Database 執行的 SQL 敘述句。它可讓具備 MongoDB 技能集的開發人員撰寫適用於 Oracle Database 的 JSON 文件存放區應用程式，這些應用程式使用瞭解 MongoDB 通訊協定的驅動程式和工具。請參閱 Oracle Database API for MongoDB 中的 Oracle Database API for MongoDB 簡介，瞭解此 API 的詳細總覽。

啟用 MongoDB API

您可以從 OCI 主控台啟用自治式 AI 資料庫的 MongoDB API，或使用 Oracle REST Data Services (ORDS) 手動啟用。

若要將 MongoDB API 與自治式 AI 資料庫搭配使用，您必須分別安裝並設定客戶管理的 Oracle REST Data Services (ORDS)，且 ORDS 的版本必須是 22.3 或更新版本。請參閱 Oracle REST Data Services Installation and Configuration Guide 中的 Oracle API for MongoDB Support ，瞭解此 API 的架構概念。

若要從 OCI 主控台啟用 MongoDB API，請執行下列動作：

您也可以在啟動設定或複製執行處理時，選取顯示進階選項並選取工具頁籤來啟用 MongoDB API。

手動啟用 MongoDB：

如需上述步驟的示範，請參閱 Oracle REST Data Services Installation and Configuration Guide 中的 Getting Started 。

連線 MongoDB 應用程式

啟用 MongoDB API 之後，您可以建立 MongoDB 使用者並使用其連線字串連線至自治式 AI 資料庫。

透過 MongoDB API 連線字串，您可以使用 MongoDB Shell (命令行公用程式) 來連線及查詢資料。

您可以從 Oracle Cloud Infrastructure 主控台擷取其連線字串。若要擷取 MongoDB API 連線字串，請執行下列動作：

  1. 在「自治式 AI 資料庫」詳細資訊頁面上，選取工具組態頁籤。

  2. 在 MongoDB API 資料列的存取 URL 底下，按一下複製。

如果在 Exadata Cloud@Customer 上的自治式 AI 資料庫上使用 MongoDB API，您的網路 /DNS 團隊必須確保任何 MongoDB 連線字串主機名稱都會解析成叢集的 SCAN。若未這麼做，MongoDB 從屬端將無法連線至資料庫。您可以允許使用萬用字元 DNS 記錄連線至叢集內的所有自治式 AI 資料庫，或允許特定自治式 AI 資料庫：

測試 MongoDB 連線

建立 MongoDB 的測試自治式 AI 資料庫使用者

您可以建立測試使用者或類似認證的使用者來進行測試。

  1. 開啟您自治式 AI 資料庫的 OCI 主控台。

  2. 按一下資料庫動作。

  3. 從「資料庫動作啟動畫面」中，按一下管理 > 資料庫使用者。

  4. 按一下「資料庫使用者 (Database Users)」頁面上的 + 建立使用者 (Create User) 。

  5. 輸入測試使用者的使用者名稱和密碼。按一下 Web 存取，然後設定表格空間 DATA 的配額。

  6. 按一下授權的角色頁籤。

  7. 除了預設角色之外，請為使用者選取並新增 SODA_APP 角色。

  8. 按一下建立使用者。

使用命令行測試連線

  1. 以測試使用者身分登入。請遵循上一個範例中的步驟以取得說明。

     $ 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**
 >

  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 範例測試您的連線。

    a. 建立新目錄。

       $ mkdir autonomous_mongodb
   $ cd autonomous_mongodb
   $ npm init -y

    b. 安裝 Mongodb 相依性。

       $ npm install mongodb

    c. 建立名為 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);

d. 執行範例。執行結果看起來應如下所示。

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

保留字元的 URI 百分比編碼

使用 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 連線字串的一部分。在此情況下，您可能不需要將其中包含的任何保留字元編碼。

相關內容