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

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

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

• Autonomous Database Free Container Imageライセンス
  Autonomous Database Free Container Imageのライセンスについて説明します。
• Autonomous Databaseの無料コンテナ・イメージ機能
  Autonomous Databaseの無料コンテナ・イメージは、Autonomous Databaseサーバーレスで使用可能な多くの機能を提供します。
• Autonomous Databaseの無料コンテナ・イメージの推奨事項および制限事項
  無料コンテナ・イメージの要件および制限事項について説明します。

Autonomous Database Free Container Imageを取得できる場所には、Oracle Cloud Infrastructure Registry (Container Registry)やGitHubなど、複数の場所があります。

1. podman仮想マシンを起動します。
   たとえば:

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

2. フリー・コンテナ・イメージを取得します。

   Oracle Cloud Infrastructure Registry:

   たとえば、podmanコマンドを使用して、最新のフリー・コンテナ・イメージをプルします。

   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パッケージからフリー・コンテナ・イメージをプルします:

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

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

   たとえば:

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

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

1. コンテナを起動して、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インスタンスに接続できます。

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

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

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_%L.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_%L.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. インポート・データの検証