LoginSignup
0
0

More than 1 year has passed since last update.

@Bassline303

【Oracle Cloud】Node.jsアプリケーションからAutonomous JSON Databaseに接続してみた

Last updated at Posted at 2021-05-28

はじめに

本記事では、Oracle CloudのAutonomous JSON Database（以下AJD）に、
OCIのComputeインスタンス上のNode.jsアプリケーションから接続する方法を紹介します。

前提条件

Autonomous JSON DatabaseのDatabaseバージョン：19.5.0.0.0
ComputeインスタンスのOS:Oracle Linux 7.9

Oracle Instant Clientのインストール

まずはComputeインスタンスに、Oracle Instant Clientをインストールします。
OCIのOracle LinuxはyumリポジトリからOracle Instant Clientをインストールすることが可能ですが、
今回は最新版のOracle Instant Client (2021/5/28時点ではInstant Client21.1) をインストールしたいため、以下URLから各種zipファイルをダウンロードします。
https://www.oracle.com/jp/database/technologies/instant-client/linux-x86-64-downloads.html

  • instantclient-basic-linux.x64-18.3.0.0.0dbru.zip
  • instantclient-sqlplus-linux.x64-18.3.0.0.0dbru.zip

任意のディレクトリ（今回は/home/opc/oracle）にダウンロードしたzipファイルを置きます。

$ pwd
/home/opc/oracle

$ ls -la
total 78320
drwxrwxr-x.  2 opc opc     4096 May 20 14:43 .
drwx------. 13 opc opc     4096 May 20 14:43 ..
-rw-r--r--.  1 opc opc 79250994 May 20 14:01 instantclient-basic-linux.x64-21.1.0.0.0.zip
-rw-r--r--.  1 opc opc   936169 May 20 14:01 instantclient-sqlplus-linux.x64-21.1.0.0.0.zip

zipファイルを展開し、SQL*Plusのバイナリファイルと共有ライブラリのPATHを通します。

$ unzip instantclient-basic-linux.x64-21.1.0.0.0.zip 
$ unzip instantclient-sqlplus-linux.x64-21.1.0.0.0.zip

$ ls -la
total 78324
drwxrwxr-x.  3 opc opc     4096 May 20 14:45 .
drwx------. 13 opc opc     4096 May 20 14:43 ..
drwxrwxr-x.  3 opc opc     4096 May 20 14:45 instantclient_21_1
-rw-r--r--.  1 opc opc 79250994 May 20 14:01 instantclient-basic-linux.x64-21.1.0.0.0.zip
-rw-r--r--.  1 opc opc   936169 May 20 14:01 instantclient-sqlplus-linux.x64-21.1.0.0.0.zip

$ export PATH=/home/opc/oracle/instantclient_21_1:$PATH
$ export LD_LIBRARY_PATH=/home/opc/oracle/instantclient_21_1:$LD_LIBRARY_PATH

Walletのダウンロードと接続確認

ドキュメントを参考に、AJDを作成します。
https://docs.oracle.com/cd/E83857_01/paas/autonomous-json-database/ajdug/autonomous-provision.html#GUID-0B230036-0A05-4CA3-AF9D-97A255AE0C08

作成したAJDのWalletファイルをダウンロードします。
AJDの詳細画面の「DB接続」をクリックします。
image.png

「ウォレットのダウンロード」をクリックします。
image.png

ウォレットのパスワードを入力し、「ダウンロード」をクリックします。
image.png

ダウンロードしたWalletファイルを、/home/opc/wallet上に展開します。

$ pwd
/home/opc/wallet

$ ls -la
total 24
drwxrwxr-x. 2 opc opc    32 May 20 08:12 .
drwx------. 8 opc opc  4096 May 20 08:12 ..
-rw-r--r--. 1 opc opc 20366 May 20 07:26 Wallet_AJDTEST.zip

//Walletファイルをunzip
$ unzip Wallet_AJDTEST.zip 

$ ls -la
total 68
drwxrwxr-x. 2 opc opc  4096 May 20 07:35 .
drwx------. 7 opc opc  4096 May 20 07:33 ..
-rw-rw-r--. 1 opc opc  6661 May 20 07:26 cwallet.sso
-rw-rw-r--. 1 opc opc  6616 May 20 07:26 ewallet.p12
-rw-rw-r--. 1 opc opc  3242 May 20 07:26 keystore.jks
-rw-rw-r--. 1 opc opc   691 May 20 07:26 ojdbc.properties
-rw-rw-r--. 1 opc opc   317 May 20 07:26 README
-rw-rw-r--. 1 opc opc   114 May 20 07:26 sqlnet.ora
-rw-rw-r--. 1 opc opc  1796 May 20 07:26 tnsnames.ora
-rw-rw-r--. 1 opc opc  3335 May 20 07:26 truststore.jks
-rw-r--r--. 1 opc opc 20366 May 20 07:26 Wallet_AJDTEST.zip

sqlnet.oraのWALLET_LOCATIONのDIRECTORYをWalletファイルの展開先（/home/opc/wallet）に変更します。

sqlnet.ora
WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="/home/opc/wallet")))
SSL_SERVER_DN_MATCH=yes

TNS_ADMIN環境変数に/home/opc/walletをセットします。

$ export TNS_ADMIN=/home/opc/wallet

tnsnames.oraで接続サービス名を確認し、SQL*PlusでAJDに接続確認を行います。

$ sqlplus admin/'password'@ajdtest_low

SQL*Plus: Release 21.0.0.0.0 - Production on Thu May 20 15:00:59 2021
Version 21.1.0.0.0

Copyright (c) 1982, 2020, Oracle.  All rights reserved.

Last Successful login time: Thu May 20 2021 14:48:28 +00:00

Connected to:
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.5.0.0.0

SQL>

無事にAJDに接続することができました。

アプリケーション用ユーザーの作成

SQL*PlusでAJDに接続し、Node.jsアプリケーションから接続するユーザーを作成します。

SQL> CREATE USER appuser IDENTIFIED BY "パスワード" DEFAULT TABLESPACE data TEMPORARY TABLESPACE temp account unlock quota unlimited on data;

User created.

作成したappuserに下記の権限を付与します。

grant  connect
     , resource
     , create session
     , create table
     , create procedure
     , create sequence
     , create trigger
     , create view
     , create synonym
     , alter  session
     , create type
     , soda_app
     to appuser;

appuserでデータベースへの接続確認を行います。

$ sqlplus appuser@ajdtest_low

SQL*Plus: Release 18.0.0.0.0 - Production on Thu May 20 08:24:03 2021
Version 18.3.0.0.0

Copyright (c) 1982, 2018, Oracle.  All rights reserved.

Enter password: 

Connected to:
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.5.0.0.0

SQL> show user;
USER is "APPUSER"

Node.jsアプリケーションからAJDへの接続

Node.jsの公式サイトで紹介されている、NodeSourceのリポジトリを追加して、yumでインストールをします。

//バージョンはLTS (2021/5/20 時点ではv14.17.0) を指定
$ curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
$ sudo yum install -y nodejs

//バージョンを確認
$ node -v
v14.17.0

アプリケーション用のディレクトリを作成し、npm initでpackage.jsonを作成します。

$ mkdir app
$ cd app
$ npm init
This utility will walk you through creating a package.json file.
It only covers the most common items, and tries to guess sensible defaults.

See `npm help init` for definitive documentation on these fields
and exactly what they do.

Use `npm install <pkg>` afterwards to install a package and
save it as a dependency in the package.json file.

Press ^C at any time to quit.
package name: (app) 
version: (1.0.0) 
description: 
entry point: (index.js) 
test command: 
git repository: 
keywords: 
author: 
license: (ISC) 
About to write to /home/opc/app/package.json:

{
  "name": "app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC"
}


Is this OK? (yes) 

$ ls -la
total 8
drwxrwxr-x.  2 opc opc   26 May 20 09:25 .
drwx------. 11 opc opc 4096 May 20 09:25 ..
-rw-rw-r--.  1 opc opc  199 May 20 09:25 package.json

アプリケーションディレクトリに移動し、node-oracledbライブラリをインストールします。

$ cd app
$ npm install oracledb

コードを書いていきます。下記の記事のサンプルコードを参考にしました。
https://blogs.oracle.com/opal/writing-nodejs-apps-for-oracle-autonomous-json-database

test.js
const oracledb = require('oracledb');

// The general recommendation for simple SODA usage is to enable autocommit
oracledb.autoCommit = true;

async function run() {
    let connection;

    try {
        connection = await oracledb.getConnection(
            {
                user: 'appuser',
                password: process.env.MYPW,
                connectString: 'ajdtest_low' //AJDの接続サービス名
            });

        // SODAオブジェクトを作成
        const soda = connection.getSodaDatabase();

        // SODA Collectionの作成
        collection = await soda.createCollection("mycollection");

        // ドキュメントをInsert 
        content = { name: "Matilda", address: { city: "Melbourne" } };
        doc = await collection.insertOneAndGet(content);
        const key = doc.key;
        console.log("The key of the new SODA document is: ", key);

        // ドキュメントの取得
        doc = await collection.find().fetchArraySize(0).key(key).getOne(); // A SodaDocument
        content = doc.getContent();                                        // A JavaScript object
        console.log(content);

    } catch (err) {
        console.error(err);
    } finally {
        if (connection) {
            try {
                await connection.close();
            } catch (err) {
                console.error(err);
            }
        }
    }
}

run();

AJDのアプリケーションユーザのパスワードを環境変数MYPWにセットします。

$ export MYPW="パスワードを入力"

test.jsを実行します。

$ node test.js
The key of the new SODA document is:  214C0B27FE324F32BF7C871BDB6EA404
{ name: 'Matilda', address: { city: 'Melbourne' } }

無事にNode.jsからAJDに接続し、データを投入・取得することができました。

参考リンク

https://blogs.oracle.com/opal/writing-nodejs-apps-for-oracle-autonomous-json-database
https://oracle.github.io/node-oracledb/doc/api.html#sodadocgetcontent
https://docs.oracle.com/cd/E83857_01/paas/autonomous-json-database/ajdug/autonomous-provision.html#GUID-0B230036-0A05-4CA3-AF9D-97A255AE0C08

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0