リポジトリからOracle Autonomous Database Free Container Imageにアクセスし、ローカル環境で実行できます。

Autonomous Databaseは、Oracle Cloud Infrastructureで使用可能なフルマネージドOracle Databaseを提供します。Oracle Cloud Infrastructureでは、ライフサイクル管理操作を実行し、Oracle Cloud Infrastructureコンソールを使用してAutonomous Databaseを実行し、パブリック・インターネットまたは設定したプライベート・ネットワークを介して(ネットワーク構成およびセキュリティのニーズに応じて)データベースに接続します。

Oracle Autonomous Database Free Container Imageは、Oracle Cloud Infrastructureコンソールまたはインターネットにアクセスすることなく、独自の環境のコンテナでAutonomous Databaseを実行する代替手段を提供します。コンテナでAutonomous Databaseを実行すると、コンテナはローカルの分離された環境を提供し、Oracle Autonomous Databaseの機能の開発、テストおよび探索のための追加オプションを提供します。

• Oracle Autonomous Database Free Container Imageライセンス
  Oracle Autonomous Database Free Container Imageのライセンスについて説明します。
• Oracle Autonomous Database Free Container Imageの機能
  Oracle Autonomous Database Free Container Imageには、Autonomous Databaseサーバーレスで使用可能な機能の多くが用意されています。
• Oracle Autonomous Database Free Container Imageの推奨事項と制限事項
  Autonomous Database Free Container Imageの要件と制限事項について説明します。

Oracle Autonomous Database Free Container Imageを取得できる場所には、Oracle Cloud Infrastructure Registry (コンテナ・レジストリ)やGitHubなど、複数の場所があります。

1. podman仮想マシンを起動します。
   次に例を示します。

   podman machine init 
   podman machine set --cpus 4 --memory 8192 
   podman machine start 

2. Autonomous Database Free Container Imageを取得します。

   Oracle Cloud Infrastructure Registry:

   たとえば、podmanコマンドを使用して、最新のAutonomous Database Free Container Imageイメージをプルします:

   podman pull container-registry.oracle.com/database/adb-free:latest-23ai

   ノート
   
   

   Oracle Autonomous Database Serverlessでは、19cコンテナ・イメージもサポートされています。

   • 19cコンテナ・イメージ名の場合、データベース・バージョンとしてlatestタグを指定します。

   • 前述の例で、Autonomous Database Free Container Image 19cをプルするには、イメージ名タグで次のコマンドを使用します:

     podman pull container-registry.oracle.com/database/adb-free:latest

   ドキュメント全体を通して、イメージ名タグはlatest-23aiバージョンを参照します。

   詳細および追加情報については、Oracle Cloud Infrastructure Registryで「Oracle Autonomous Database Free」を検索してください。

   GitHubパッケージ:

   たとえば、podmanコマンドを使用して、GitHubパッケージからAutonomous Database Free Container Imageをプルします:

   podman pull ghcr.io/oracle/adb-free:latest-23ai

3. イメージを確認します。

   たとえば:

   podman images container-registry.oracle.com/database/adb-free:latest-23ai

Oracle Autonomous Database Free Container Imageをダウンロードした後、コンテナでイメージを起動できます。

1. Autonomous Database Free Container Imageを実行するコンテナを起動します。

   たとえば、podmanの場合:

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name adb-free \
   container-registry.oracle.com/database/adb-free:latest-23ai

   コマンド・ノート:

   • Autonomous Database Serverlessでは、19cコンテナ・イメージもサポートされています。

     • 19cコンテナ・イメージ名の場合、データベース・バージョンとしてlatestタグを指定します。

     • 前述の例で、Autonomous Database Free Container Image 19cを実行するコンテナを起動するには、イメージ名タグで次のコマンドを使用します:

       container-registry.oracle.com/database/adb-free:latest

   • ドキュメント全体を通して、イメージ名タグはlatest-23aiバージョンを参照します。

   • WORKLOAD_TYPEは、ATPまたはADWのいずれかです。デフォルト値はATPです。

   • デフォルトでは、渡されたWORKLOAD_TYPE値に応じて、データベースの名前はMYATPまたはMYADWになります。オプションで、デフォルトとは異なるデータベース名が必要な場合は、DATABASE_NAMEパラメータを設定できます。データベース名に使用できるのは英数字のみです。

   • コンテナの起動時に、対応するMY<WORKLOAD_TYPE>.pdbがパブリック・オブジェクト・ストレージ・バケットからダウンロードおよびプラグインされます。

   • ウォレットは、指定されたWALLET_PASSWORDを使用して生成されます。

   • 初期ログイン時にADMIN_PASSWORDを変更する必要があります。

   • ADMIN_PASSWORDを作成または変更する場合は、次の要件を確認してください。
     • パスワードは、12文字から30文字までの長さとし、大文字、小文字および数字をそれぞれ1文字以上含める必要があります。
     • パスワードにユーザー名を含めることはできません。
   • WALLET_PASSWORDを作成または変更する場合は、次の要件を確認してください。
     • パスワードは、8から30文字の長さで、数字または特殊文字と組み合せたアルファベット文字を含める必要があります。

   • OFSマウントの場合、コンテナはSYS_ADMIN機能で始まります。また、仮想デバイス/dev/fuseにアクセスできる必要があります。

   • この -pオプションは、次のポートがコンテナプロセスに転送されることを指定します。

     ポート番号	説明
     1521	TLS
     1522	mTLS
     8443	ORDS/APEXおよびデータベース・アクションのHTTPSポート
     27017	Mongo API

   企業プロキシの背後にいる場合は、プロキシの環境変数を指定する -eオプションを含めます。たとえば、podmanの場合:

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   -e http_proxy=http://example-corp-proxy.com:80/ \
   -e https_proxy=http://example-corp-proxy.com:80/ \
   -e no_proxy=localhost,127.0.0.1 \
   -e HTTP_PROXY=http://example-corp-proxy.com:80/  \
   -e HTTPS_PROXY=http://example-corp-proxy.com:80/  \
   -e NO_PROXY=localhost,127.0.0.1 \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name adb-free \
   container-registry.oracle.com/database/adb-free:latest-23ai

adb-cliコマンドライン・ユーティリティを使用して、コンテナの起動および実行後にデータベース操作を実行できます。

alias adb-cli="podman exec <container_name> adb-cli"

adb-cli --help 
Usage: adb-cli [OPTIONS] COMMAND [ARGS]... 
    ADB-S Command Line Interface (CLI) to perform container-runtime database operations 
Options: 
    -v, --version Show the version and exit. 
    --help Show this message and exit. 
Commands: 
    add-database 
    change-password 

adb-cli add-database --workload-type "ATP" --admin-password "Welcome_MY_ATP_1234" 

adb-cli change-password --database-name "MYATP" 
    --old-password "Welcome_MY_ATP_1234" --new-password "Welcome_12345"

Autonomous Database Free Container Imageがコンテナで実行されている場合、Autonomous Databaseインスタンスに接続できます。

コンテナで実行されているAutonomous Databaseインスタンスに接続するには、ウォレットを設定して接続するか、TLSウォレットレス接続を使用します。

• ORDS/APEX/データベース・アクション
  コンテナhostnameは、ポート8443でHTTPSトラフィックを処理するための自己署名SSL証明書を生成するために使用されます。Oracle APEXおよびデータベース・アクションには、コンテナ・ホスト(または単にlocalhost)を使用してアクセスできます。
• 使用可能なTNS別名
  次のいずれかの別名を使用して、Autonomous Database空きコンテナに接続できます。
• WalletおよびConnectの設定
  
• TLS Walletless接続および接続の設定
  

1. ポッドマンのボリュームを作成します。

   たとえば、次のとおりです。

   podman volume create adb_container_volume

2. ボリュームマウントポイントを確認します。

   マウントポイントは、ポッドマン管理ディレクトリの場所です。

   podman inspect adb_container_volume
    
   [
        {
             "Name": "adb_container_volume",
             "Driver": "local",
             "Mountpoint": "/share/containers/storage/volumes/adb_container_volume/_data",
             "CreatedAt": "2023-09-11T21:23:34.305877073Z",
             "Labels": {},
             "Scope": "local",
             "Options": {},
             "MountCount": 0,
             "NeedsCopyUp": true,
             "NeedsChown": true
        }
   ]

3. ソース・コンテナを起動し、コンテナ内の/u01/dataにボリュームをマウントします。

   たとえば、次のとおりです。

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name source_adb_container \
   --volume adb_container_volume:/u01/data \
   container-registry.oracle.com/database/adb-free:latest-23ai

   ノート
   
   

   Autonomous Database Serverlessでは、19cコンテナ・イメージもサポートされています。

   • 19cコンテナ・イメージ名の場合、データベース・バージョンとしてlatestタグを指定します。

   • 前述の例で、Autonomous Database Free Container Image 19cを起動するには、イメージ名タグで次のコマンドを使用します:

     container-registry.oracle.com/database/adb-free:latest

   ドキュメント全体を通して、イメージ名タグはlatest-23aiバージョンを参照します。

4. この例では、スキーマapp_userにデータをすでに作成していることを前提としています。
5. app_userのスキーマからコンテナ・ボリュームにデータをエクスポートします。
   1. ADMINとして接続し、/u01/dataを指すORA_EXP_DIRディレクトリを作成します。

      sqlplus admin/**************@myadw_high
       
      SQL> exec DBMS_CLOUD_CONTAINER_ADMIN.create_export_directory('/u01/data');
      

      SQL> select directory_path from dba_directories where directory_name='ORA_EXP_DIR';
      
      DIRECTORY_PATH
      --------------------------------------------------------------------------------
      /u01/data

   2. スキーマ・モードおよびADMINスキーマとAPP_USERスキーマの両方でエクスポート・ジョブを実行します。

      SET scan off
      SET serveroutput ON
      SET escape off
        
      DECLARE
          h1 NUMBER;
          s VARCHAR2(1000):=NULL;
          errorvarchar VARCHAR2(100):= 'ERROR';
          tryGetStatus NUMBER := 0;
          success_with_info EXCEPTION;
          PRAGMA EXCEPTION_INIT(success_with_info, -31627);
      BEGIN
          h1 := dbms_datapump.OPEN(operation => 'EXPORT', job_mode => 'SCHEMA', job_name => 'EXPORT_MY_ADW_4', version => 'COMPATIBLE');
          tryGetStatus := 1;
          dbms_datapump.add_file(handle => h1, filename => 'EXPORT_MY_ADW.LOG', directory => 'ORA_EXP_DIR', filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);
          dbms_datapump.metadata_filter(handle => h1, name => 'SCHEMA_EXPR', VALUE => 'IN(''ADMIN'', ''APP_USER'')');
          dbms_datapump.add_file(handle => h1, filename => 'MY_ADW_%U.DMP', directory => 'ORA_EXP_DIR', filesize => '500M',  filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_DUMP_FILE);
          dbms_datapump.start_job(handle => h1, skip_current => 0, abort_step => 0);
          dbms_datapump.detach(handle => h1);
          errorvarchar := 'NO_ERROR';
      EXCEPTION
          WHEN OTHERS THEN
          BEGIN
              IF ((errorvarchar = 'ERROR')AND(tryGetStatus=1)) THEN
                  DBMS_DATAPUMP.DETACH(h1);
              END IF;
          EXCEPTION
          WHEN OTHERS THEN
              NULL;
          END;
          RAISE;
      END;
      /

6. エクスポートを検証します。

   コンテナ/u01/data内のファイルをリストします。

   podman exec -it source_adb_container bash
   cd /u01/data

   エクスポート・ログ(export log)を確認し、エラーがないか確認して、正常に完了しました。

7. ソース・コンテナを停止して削除します。

   podman stop source_adb_container
   podman rm source_adb_container

   ノート
   
   adb_container_volumeは、コンテナの再起動および削除後も存続します
8. コンテナ内の/u01/dataに同じボリュームをマウントする宛先コンテナを起動します。

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name dest_adb_container \
   --volume adb_container_volume:/u01/data \
   container-registry.oracle.com/database/adb-free:latest-23ai

9. 宛先コンテナにデータをインポートします。

   ADMINとして接続し、 /u01/dataを指すORA_EXP_DIRディレクトリを作成します。

   SQL> exec DBMS_CLOUD_CONTAINER_ADMIN.create_export_directory('/u01/data');
    
   PL/SQL procedure successfully completed.
    
   SQL> select directory_path from dba_directories where directory_name='ORA_EXP_DIR';
    
   DIRECTORY_PATH
   --------------------------------------------------------------------------------
   /u01/data

10. PL/SQLのインポート・コマンドを実行します。

    SET scan off
    SET serveroutput ON
    SET escape off
      
    DECLARE
        h1 NUMBER;
        s VARCHAR2(1000):=NULL;
        errorvarchar VARCHAR2(100):= 'ERROR';
        tryGetStatus NUMBER := 0;
        success_with_info EXCEPTION;
        PRAGMA EXCEPTION_INIT(success_with_info, -31627);
    BEGIN
        h1 := dbms_datapump.OPEN(operation => 'IMPORT', job_mode => 'SCHEMA', job_name => 'IMPORT_MY_ADW_4', version => 'COMPATIBLE');
        tryGetStatus := 1;
        dbms_datapump.add_file(handle => h1, filename => 'IMPORT_MY_ADW.LOG', directory => 'ORA_EXP_DIR', filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);
        dbms_datapump.metadata_filter(handle => h1, name => 'SCHEMA_EXPR', VALUE => 'IN(''ADMIN'', ''APP_USER'')');
        dbms_datapump.add_file(handle => h1, filename => 'MY_ADW_%U.DMP', directory => 'ORA_EXP_DIR', filesize => '500M',  filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_DUMP_FILE);
        dbms_datapump.start_job(handle => h1, skip_current => 0, abort_step => 0);
        dbms_datapump.detach(handle => h1);
        errorvarchar := 'NO_ERROR';
    EXCEPTION
        WHEN OTHERS THEN
        BEGIN
            IF ((errorvarchar = 'ERROR')AND(tryGetStatus=1)) THEN
                DBMS_DATAPUMP.DETACH(h1);
            END IF;
        EXCEPTION
        WHEN OTHERS THEN
            NULL;
        END;
        RAISE;
    END;
    /

11. インポート・ログを検証します。
12. インポート・データの検証