@things-factory/integration-base 7.0.0-alpha.4 → 7.0.0-alpha.7

package/helps/integration/connector/oracle-connector.ja.md

@@ -0,0 +1,90 @@
+# Oracle コネクタ
+
+## サポート
+
+    1. Oracle Client ライブラリのバージョン 11.2 以降が必要です
+    2. Oracle データベース 10g 以降に接続可能
+
+## 設定
+
+### MAC OS
+
+- Oracle クライアントのインストール
+
+  ```sh
+  cd $HOME/Downloads
+  curl -O https://download.oracle.com/otn_software/mac/instantclient/198000/instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  hdiutil mount instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru/install_ic.sh
+  hdiutil unmount /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru
+
+  ln -s ~/Downloads/instantclient_19_8/libclntsh.dylib node_modules/oracledb/build/Release
+  ```
+
+### Linux
+
+- Oracle パスの作成
+  ```sh
+  mkdir -p /opt/oracle
+  cd /opt/oracle
+  ```
+- Oracle データベースに接続するための最新の Oracle クライアントのダウンロード
+  ```sh
+  wget https://download.oracle.com/otn_software/linux/instantclient/instantclient-basiclite-linuxx64.zip && \
+      unzip instantclient-basiclite-linuxx64.zip && \
+      rm -f instantclient-basiclite-linuxx64.zip && \
+      cd /opt/oracle/instantclient* && \
+      rm -f *jdbc* *occi* *mysql* *mql1* *ipc1* *jar uidrvci genezi adrci && \
+      echo /opt/oracle/instantclient* > /etc/ld.so.conf.d/oracle-instantclient.conf &&\
+      ldconfig
+  ```
+
+### 詳細はこちらを参照してください
+
+- https://oracle.github.io/node-oracledb/INSTALL.html
+
+## エンドポイント
+
+Oracle エンジンのホスト名とサービスポート
+
+- hostname : データベースサーバのホスト
+- service port : データベースサービスポート（デフォルト - 1521）
+- 形式
+  - {hostname}[:{port}]
+  - 例
+    - "localhost:1521"
+    - "localhost"
+    - "192.168.0.1:1521"
+
+## パラメータ
+
+### user
+
+- Oracle データベースのユーザー ID
+
+### password
+
+- Oracle データベースのユーザーパスワード
+
+### database
+
+- Oracle SID 名
+
+### pool-increment
+
+- 接続プールの増分サイズ
+- デフォルト値 1
+
+### min. connection pool
+
+- プールが作成されたときにデータベースに確立される接続数。これはまた、プールが縮小したときにプールが維持する最小の接続数です。
+- デフォルト値 0
+
+### max. connection pool
+
+- 接続プールが成
+
+長できる最大の接続数。
+
+- 重要なのは、"max. connection pool" を増加させた場合、node-oracledb で使用可能なスレッド数も増やす必要があります。[接続数とスレッド数](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#numberofthreads)を参照してください。
+- デフォルト値 4

package/helps/integration/connector/oracle-connector.ko.md

@@ -0,0 +1,87 @@
+# 오라클 커넥터
+
+## 지원
+
+    1. 오라클 클라이언트 라이브러리 버전 11.2 이상 필요
+    2. 오라클 데이터베이스 10g 이상에 연결할 수 있음
+
+## 설정
+
+### MAC OS
+
+- 오라클 클라이언트 설치
+
+  ```sh
+  cd $HOME/Downloads
+  curl -O https://download.oracle.com/otn_software/mac/instantclient/198000/instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  hdiutil mount instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru/install_ic.sh
+  hdiutil unmount /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru
+
+  ln -s ~/Downloads/instantclient_19_8/libclntsh.dylib node_modules/oracledb/build/Release
+  ```
+
+### 리눅스
+
+- 오라클 경로 생성
+  ```sh
+  mkdir -p /opt/oracle
+  cd /opt/oracle
+  ```
+- 오라클 데이터베이스에 연결하기 위한 최신 오라클 클라이언트 다운로드
+  ```sh
+  wget https://download.oracle.com/otn_software/linux/instantclient/instantclient-basiclite-linuxx64.zip && \
+      unzip instantclient-basiclite-linuxx64.zip && \
+      rm -f instantclient-basiclite-linuxx64.zip && \
+      cd /opt/oracle/instantclient* && \
+      rm -f *jdbc* *occi* *mysql* *mql1* *ipc1* *jar uidrvci genezi adrci && \
+      echo /opt/oracle/instantclient* > /etc/ld.so.conf.d/oracle-instantclient.conf &&\
+      ldconfig
+  ```
+
+### 자세한 내용은 참조하세요
+
+- https://oracle.github.io/node-oracledb/INSTALL.html
+
+## 엔드포인트
+
+오라클 엔진 호스트 이름 및 서비스 포트
+
+- hostname : 데이터베이스 서버 호스트
+- service port : 데이터베이스 서비스 포트 (기본값 - 1521)
+- 형식
+  - {hostname}[:{port}]
+  - 예.
+    - "localhost:1521"
+    - "localhost"
+    - "192.168.0.1:1521"
+
+## 파라미터
+
+### user
+
+- 오라클 데이터베이스 사용자 ID
+
+### password
+
+- 오라클 데이터베이스 사용자 비밀번호
+
+### database
+
+- 오라클 SID 이름
+
+### pool-increment
+
+- 연결 풀 증가 크기
+- 기본값 1
+
+### min. connection pool
+
+- 풀이 생성될 때 데이터베이스에 설정된 연결 수. 또한 이는 풀이 축소될 때 풀이 유지하는 최소 연결 수입니다.
+- 기본값 0
+
+### max. connection pool
+
+- 연결 풀이 성장할 수 있는 최대 연결 수.
+- 중요하게, "max. connection pool"을 증가시킨다면, node-oracledb에 사용 가능한 스레드 수도 증가시켜야 합니다. [연결 및 스레드 수](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#numberofthreads)를 참조하세요.
+- 기본값 4

package/helps/integration/connector/oracle-connector.md

@@ -1,41 +1,47 @@
 # Oracle connector
 
 ## Support
+
     1. requires Oracle Client libraries version 11.2 or later
     2. Can connect to Oracle Database 10g or later
 
 ## Setting
+
 ### MAC OS
-* install oracle client 
-    ```sh
-    cd $HOME/Downloads
-    curl -O https://download.oracle.com/otn_software/mac/instantclient/198000/instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
-    hdiutil mount instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
-    /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru/install_ic.sh
-    hdiutil unmount /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru
 
-    ln -s ~/Downloads/instantclient_19_8/libclntsh.dylib node_modules/oracledb/build/Release
-    ```
+- install oracle client
+
+  ```sh
+  cd $HOME/Downloads
+  curl -O https://download.oracle.com/otn_software/mac/instantclient/198000/instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  hdiutil mount instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru/install_ic.sh
+  hdiutil unmount /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru
+
+  ln -s ~/Downloads/instantclient_19_8/libclntsh.dylib node_modules/oracledb/build/Release
+  ```
 
 ### Linux
-* make oracle path
-    ```sh
-    mkdir -p /opt/oracle
-    cd /opt/oracle
-    ```
-* download newest oracle cilent for connect to Oracle Database
-    ```sh
-    wget https://download.oracle.com/otn_software/linux/instantclient/instantclient-basiclite-linuxx64.zip && \
-        unzip instantclient-basiclite-linuxx64.zip && \ 
-        rm -f instantclient-basiclite-linuxx64.zip && \
-        cd /opt/oracle/instantclient* && \
-        rm -f *jdbc* *occi* *mysql* *mql1* *ipc1* *jar uidrvci genezi adrci && \
-        echo /opt/oracle/instantclient* > /etc/ld.so.conf.d/oracle-instantclient.conf &&\
-        ldconfig
-    ```
+
+- make oracle path
+  ```sh
+  mkdir -p /opt/oracle
+  cd /opt/oracle
+  ```
+- download newest oracle cilent for connect to Oracle Database
+  ```sh
+  wget https://download.oracle.com/otn_software/linux/instantclient/instantclient-basiclite-linuxx64.zip && \
+      unzip instantclient-basiclite-linuxx64.zip && \
+      rm -f instantclient-basiclite-linuxx64.zip && \
+      cd /opt/oracle/instantclient* && \
+      rm -f *jdbc* *occi* *mysql* *mql1* *ipc1* *jar uidrvci genezi adrci && \
+      echo /opt/oracle/instantclient* > /etc/ld.so.conf.d/oracle-instantclient.conf &&\
+      ldconfig
+  ```
+
 ### Detail please Refer
-* https://oracle.github.io/node-oracledb/INSTALL.html
 
+- https://oracle.github.io/node-oracledb/INSTALL.html
 
 ## endpoint
 
@@ -64,3 +70,18 @@ Oracle engine hostname and service port
 
 - oracle sid name
 
+### pool-increment
+
+- connection pool increment size
+- default value 1
+
+### min. connection pool
+
+- The number of connections established to the database when a pool is created. Also this is the minimum number of connections that a pool maintains when it shrinks.
+- default value 0
+
+### max. connection pool
+
+- The maximum number of connections to which a connection pool can grow.
+- Importantly, if you increase "max. connection pool", you should also increase the number of threads available to node-oracledb. See [Connections and Number of Threads](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#numberofthreads).
+- default value 4

package/helps/integration/connector/oracle-connector.ms.md

@@ -0,0 +1,87 @@
+# Oracle penghubung
+
+## Sokongan
+
+    1. memerlukan pustaka Klien Oracle versi 11.2 atau lebih tinggi
+    2. Boleh menyambung ke Pangkalan Data Oracle 10g atau lebih tinggi
+
+## Tetapan
+
+### MAC OS
+
+- pasang klien Oracle
+
+  ```sh
+  cd $HOME/Downloads
+  curl -O https://download.oracle.com/otn_software/mac/instantclient/198000/instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  hdiutil mount instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru/install_ic.sh
+  hdiutil unmount /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru
+
+  ln -s ~/Downloads/instantclient_19_8/libclntsh.dylib node_modules/oracledb/build/Release
+  ```
+
+### Linux
+
+- buat laluan Oracle
+  ```sh
+  mkdir -p /opt/oracle
+  cd /opt/oracle
+  ```
+- muat turun klien Oracle terbaru untuk menyambung ke Pangkalan Data Oracle
+  ```sh
+  wget https://download.oracle.com/otn_software/linux/instantclient/instantclient-basiclite-linuxx64.zip && \
+      unzip instantclient-basiclite-linuxx64.zip && \
+      rm -f instantclient-basiclite-linuxx64.zip && \
+      cd /opt/oracle/instantclient* && \
+      rm -f *jdbc* *occi* *mysql* *mql1* *ipc1* *jar uidrvci genezi adrci && \
+      echo /opt/oracle/instantclient* > /etc/ld.so.conf.d/oracle-instantclient.conf &&\
+      ldconfig
+  ```
+
+### Untuk maklumat lanjut sila rujuk
+
+- https://oracle.github.io/node-oracledb/INSTALL.html
+
+## titik akhir
+
+Nama hos enjin Oracle dan port perkhidmatan
+
+- hostname : hos pelayan pangkalan data
+- service port : port perkhidmatan pangkalan data (lalai - 1521)
+- format
+  - {hostname}[:{port}]
+  - contoh
+    - "localhost:1521"
+    - "localhost"
+    - "192.168.0.1:1521"
+
+## Parameter
+
+### user
+
+- ID pengguna untuk pangkalan data Oracle
+
+### password
+
+- kata laluan pengguna untuk pangkalan data Oracle
+
+### database
+
+- nama sid Oracle
+
+### pool-increment
+
+- saiz peningkatan kolam sambungan
+- nilai lalai 1
+
+### min. connection pool
+
+- Bilangan sambungan yang ditubuhkan ke pangkalan data apabila kolam dicipta. Ini juga adalah bilangan sambungan minimum yang dikekalkan oleh kolam apabila ia mengecil.
+- nilai lalai 0
+
+### max. connection pool
+
+- Bilangan maksimum sambungan yang boleh berkembang ke kolam sambungan.
+- Pentingnya, jika anda meningkatkan "max. connection pool", anda juga harus meningkatkan bilangan utas yang tersedia untuk node-oracledb. Lihat [Sambungan dan Bilangan Utas](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#numberofthreads).
+- nilai lalai 4

package/helps/integration/connector/oracle-connector.zh.md

@@ -0,0 +1,87 @@
+# Oracle 连接器
+
+## 支持
+
+    1. 需要 Oracle 客户端库版本 11.2 或更高
+    2. 可以连接到 Oracle 数据库 10g 或更高
+
+## 设置
+
+### MAC OS
+
+- 安装 Oracle 客户端
+
+  ```sh
+  cd $HOME/Downloads
+  curl -O https://download.oracle.com/otn_software/mac/instantclient/198000/instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  hdiutil mount instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg
+  /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru/install_ic.sh
+  hdiutil unmount /Volumes/instantclient-basic-macos.x64-19.8.0.0.0dbru
+
+  ln -s ~/Downloads/instantclient_19_8/libclntsh.dylib node_modules/oracledb/build/Release
+  ```
+
+### Linux
+
+- 创建 Oracle 路径
+  ```sh
+  mkdir -p /opt/oracle
+  cd /opt/oracle
+  ```
+- 下载最新的 Oracle 客户端以连接到 Oracle 数据库
+  ```sh
+  wget https://download.oracle.com/otn_software/linux/instantclient/instantclient-basiclite-linuxx64.zip && \
+      unzip instantclient-basiclite-linuxx64.zip && \
+      rm -f instantclient-basiclite-linuxx64.zip && \
+      cd /opt/oracle/instantclient* && \
+      rm -f *jdbc* *occi* *mysql* *mql1* *ipc1* *jar uidrvci genezi adrci && \
+      echo /opt/oracle/instantclient* > /etc/ld.so.conf.d/oracle-instantclient.conf &&\
+      ldconfig
+  ```
+
+### 详情请参考
+
+- https://oracle.github.io/node-oracledb/INSTALL.html
+
+## 端点
+
+Oracle 引擎主机名和服务端口
+
+- hostname : 数据库服务器主机
+- service port : 数据库服务端口（默认 - 1521）
+- 格式
+  - {hostname}[:{port}]
+  - 例如
+    - "localhost:1521"
+    - "localhost"
+    - "192.168.0.1:1521"
+
+## 参数
+
+### user
+
+- Oracle 数据库用户 ID
+
+### password
+
+- Oracle 数据库用户密码
+
+### database
+
+- Oracle SID 名称
+
+### pool-increment
+
+- 连接池增量大小
+- 默认值 1
+
+### min. connection pool
+
+- 创建池时数据库建立的连接数。这也是池缩小时保持的最小连接数。
+- 默认值 0
+
+### max. connection pool
+
+- 连接池可以增长的最大连接数。
+- 重要的是，如果你增加了“max. connection pool”，你也应该增加 node-oracledb 可用的线程数。参见[连接和线程数](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#numberofthreads)。
+- 默认值 4