Autonomous AI Database Free Container Imageの使用

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

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

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

• Autonomous AI Database Free Container Imageライセンス
  Autonomous AI Database Free Container Imageのライセンスについて説明します。
• Autonomous AI Database Free Container Imageの機能
  Autonomous AI Database Free Container Imageは、Autonomous AI Database Serverlessで使用可能な多くの機能を提供します。
• Autonomous AI Database Free Container Imageの推奨事項および制限事項
  Free Container Imageの要件および制限事項について説明します。

Autonomous AI 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. 空きコンテナ・イメージを取得します。

   Oracle Cloud Infrastructure Registry:

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

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

   ノート
   
   

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

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

   • 前述の例で、Autonomous AI Databaseフリー・コンテナ・イメージ19cをプルするには、イメージ名タグで次のコマンドを使用します:

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

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

   詳細は、Oracle Cloud Infrastructure RegistryでOracle Autonomous AI 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 AI 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 AI Databaseサーバーレスでは、19cコンテナ・イメージもサポートされます。

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

     • 前述の例で、Autonomous AI Databaseフリー・コンテナ・イメージ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 AI Databaseインスタンスに接続できます。

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

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

1. podmanボリュームを作成します。

   たとえば:

   podman volume create adb_container_volume

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

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

   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 AI Databaseサーバーレスでは、19cコンテナ・イメージもサポートされます。

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

   • 前述の例で、Autonomous AI Databaseフリー・コンテナ・イメージ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. インポート・データを検証します。