日日是Oracle APEX: Oracle Database Free 23ai 23.7にDBMS_CLOUDファミリーのパッケージをインストールする

Oracle Database 23aiのリリース・アップデート23.7より、ローカルで実行できるデータベースにCloud Developer Packagesがバンドルされました。

Oracle Database New Features - Release Update 23.7 Features

https://docs.oracle.com/en/database/oracle/oracle-database/23/nfcoa/ru_23_7.html#GUID-104803-1

リリース・ノートによるとCloud Developer Packagesには、以下のパッケージが含まれます。Autonomous Databaseに実装されている同名のパッケージに実装されていて、こちらのパッケージには無い機能もあるようです。

DBMS_CLOUD

DBMS_CLOUD_PIPELINE

DBMS_CLOUD_REPO

DBMS_CLOUD_NOTIFICATION

DBMS_CLOUD_AI

これらのパッケージは$ORACLE_HOME/rdbms/admin以下にインストール・スクリプトが含まれていますが、データベースにインストールされてはいません。パッケージを利用するには、データベースにインストールする必要があります。

パッケージのインストール手順は、ドキュメントUtilitiesの20.2 Install DBMS_CLOUDに記載されています。

Utilities - 20.2 Installing DBMS_CLOUD

https://docs.oracle.com/en/database/oracle/oracle-database/23/sutil/installing-dbms_cloud.html

以下より、マニュアルの手順に従ってインストール作業を行ってみます。インストールする環境は、Oracle Container Registryより入手できるOracle Database Free 23aiのコンテナ・イメージより作成します。Oracle Database Freeのコンテナ・イメージはARM64、AMD64版ともに23.7に更新されています。

コンテナの実行には、Apple SiliconのMac上でpodmanを使用します。

最初にOracle Database Free 23aiのコンテナを作成し実行します。コンテナの名前はoradbとします。

podman run -d --name oradb -p 1521:1521 container-registry.oracle.com/database/free:latest

% podman run -d --name oradb -p 1521:1521 container-registry.oracle.com/database/free:latest

5966443f8868e0372d28bbec70e8cb748413a0427a8f8c4300740be8246de324

コンテナoradbが利用可能になったら、SYSのパスワードを設定します。

podman exec -it oradb ./setPassword.sh [SYSのパスワード]

% podman exec -it oradb ./setPassword.sh [SYSのパスワード]

The Oracle base remains unchanged with value /opt/oracle

SQL*Plus: Release 23.0.0.0.0 - Production on Thu Mar 27 04:10:38 2025

Version 23.7.0.25.01

Connected to:

Oracle Database 23ai Free Release 23.0.0.0.0 - Develop, Learn, and Run for Free

Version 23.7.0.25.01

SQL>

User altered.

SQL>

User altered.

SQL>

Session altered.

SQL>

User altered.

SQL> Disconnected from Oracle Database 23ai Free Release 23.0.0.0.0 - Develop, Learn, and Run for Free

Version 23.7.0.25.01

DBMS_CLOUDのインストール作業を実施するために、コンテナに接続します。

podman exec -it oradb bash

% podman exec -it oradb bash

bash-4.4$

マニュアルの手順にあるcatclouduser.sqlを実行します。CDBおよびPDBにインストールするため、catcon.plを使用します。your-passwordの部分は先ほど設定したSYSのパスワードに置き換えます。

$ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u sys/your-password -force_pdb_mode 'READ WRITE' -b dbms_cloud_install -d $ORACLE_HOME/rdbms/admin/ -l /tmp catclouduser.sql

bash-4.4$ $ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u sys/[SYSのパスワード] -force_pdb_mode 'READ WRITE' -b dbms_cloud_install -d $ORACLE_HOME/rdbms/admin/ -l /tmp catclouduser.sql

catcon::set_log_file_base_path: ALL catcon-related output will be written to [/tmp/dbms_cloud_install_catcon_1021.lst]

catcon::set_log_file_base_path: catcon: See [/tmp/dbms_cloud_install*.log] files for output generated by scripts

catcon::set_log_file_base_path: catcon: See [/tmp/dbms_cloud_install_*.lst] files for spool files, if any

catcon::get_kill_sess_script_info: query produced 2 rows instead of expected 3 rows corresponding to processes 1070, 1071, 1072

catcon.pl: completed successfully

bash-4.4$

続けてdbms_cloud_install.sqlを実行します。こちらも同様にyour-passwordの部分をSYSのパスワードに置き換えます。

$ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u sys/your-password -force_pdb_mode 'READ WRITE' -b dbms_cloud_install -d $ORACLE_HOME/rdbms/admin/ -l /tmp dbms_cloud_install.sql

catcon::set_log_file_base_path: ALL catcon-related output will be written to [/tmp/dbms_cloud_install_catcon_1226.lst]

catcon::set_log_file_base_path: catcon: See [/tmp/dbms_cloud_install*.log] files for output generated by scripts

catcon::set_log_file_base_path: catcon: See [/tmp/dbms_cloud_install_*.lst] files for spool files, if any

catcon.pl: completed successfully

bash-4.4$

インストールされたデータベース・オブジェクトのステータスを確認します。

最初にCDBに接続し、以下のSELECT文を実行します。

select con_id, owner, object_name, status, sharing, oracle_maintained from cdb_objects where object_name like 'DBMS_CLOUD%';

STATUSがすべてVALIDであれば、オブジェクトは正常に作成されています。

bash-4.4$ sqlplus / as sysdba

SQL*Plus: Release 23.0.0.0.0 - Production on Thu Mar 27 04:28:57 2025

Version 23.7.0.25.01

Connected to:

Oracle Database 23ai Free Release 23.0.0.0.0 - Develop, Learn, and Run for Free

Version 23.7.0.25.01

SQL> set pages 1000 lines 180 trims on trimo on

SQL> col con_id format 9999

SQL> col owner format a18

SQL> col object_name format a30

SQL> col status format a8

SQL> col sharing format a16

SQL> col oracle_maintained format a3

SQL> select con_id, owner, object_name, status, sharing, oracle_maintained from cdb_objects where object_name like 'DBMS_CLOUD%';

CON_ID OWNER OBJECT_NAME STATUS SHARING ORA

------ ------------------ ------------------------------ -------- ---------------- ---

1 PUBLIC DBMS_CLOUD VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_AI VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_CAPABILITY VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_CORE VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_INTERNAL VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_NOTIFICATION VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_OCI_REGIONS VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_PIPELINE VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_PIPELINE_INTERNAL VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_REPO VALID METADATA LINK Y

1 PUBLIC DBMS_CLOUD_TYPES VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_AI VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE_ATTR$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE_SCHEMA$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITIES$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITIES_UNIQUE VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITY VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_CLOUD_STORE_UNIQUE VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_CONFIG_PARAM VALID DATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_CONFIG_PARAM$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_CORE VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_FILE_SYSTEM$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_FILE_SYSTEM_UNIQUE VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_INTERNAL VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_NOTIFICATION VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS VALID DATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS_UNIQUE VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PARAM_UNIQUE VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_ATTR$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_ATTR_I1$ VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_FILE$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_FILE_I1$ VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_I1$ VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_INTERNAL VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_REPO VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_REQUEST VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_REST_API_RESULTS$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_STORE VALID DATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_STORE$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASK VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASK$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASKS VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS$ VALID METADATA LINK Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS_UNIQUE VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLEANUP VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TASK_ID VALID NONE Y

1 C##CLOUD$SERVICE DBMS_CLOUD_TYPES VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_AI VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_CAPABILITY VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_CORE VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_INTERNAL VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_NOTIFICATION VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_OCI_REGIONS VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_PIPELINE VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_PIPELINE_INTERNAL VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_REPO VALID METADATA LINK Y

3 PUBLIC DBMS_CLOUD_TYPES VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_AI VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE_ATTR$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE_SCHEMA$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITIES$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITIES_UNIQUE VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITY VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_CLOUD_STORE_UNIQUE VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_CONFIG_PARAM VALID DATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_CONFIG_PARAM$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_CORE VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_FILE_SYSTEM$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_FILE_SYSTEM_UNIQUE VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_INTERNAL VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_NOTIFICATION VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS VALID DATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS_UNIQUE VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PARAM_UNIQUE VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_ATTR$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_ATTR_I1$ VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_FILE$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_FILE_I1$ VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_I1$ VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_INTERNAL VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_REPO VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_REQUEST VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_REST_API_RESULTS$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_STORE VALID DATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_STORE$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASK VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASK$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASKS VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS$ VALID METADATA LINK Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS_UNIQUE VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLEANUP VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TASK_ID VALID NONE Y

3 C##CLOUD$SERVICE DBMS_CLOUD_TYPES VALID METADATA LINK Y

128 rows selected.

SQL>

CDBビューを検索しているのですでに確認ずみではありますが、PDBとして作成されているFREEPDB1に接続し、以下のSELECT文を実行します。

select owner, object_name, status, sharing, oracle_maintained from dba_objects where object_name like 'DBMS_CLOUD%';

SQL> alter session set container = freepdb1;

Session altered.

SQL> select owner, object_name, status, sharing, oracle_maintained from dba_objects where object_name like 'DBMS_CLOUD%';

OWNER OBJECT_NAME STATUS SHARING ORA

------------------ ------------------------------ -------- ---------------- ---

PUBLIC DBMS_CLOUD VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_AI VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_CAPABILITY VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_CORE VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_INTERNAL VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_NOTIFICATION VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_OCI_REGIONS VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_PIPELINE VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_PIPELINE_INTERNAL VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_REPO VALID METADATA LINK Y

PUBLIC DBMS_CLOUD_TYPES VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_AI VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE_ATTR$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_AI_PROFILE_SCHEMA$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITIES$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITIES_UNIQUE VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_CAPABILITY VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_CLOUD_STORE_UNIQUE VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_CONFIG_PARAM VALID DATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_CONFIG_PARAM$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_CORE VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_FILE_SYSTEM$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_FILE_SYSTEM_UNIQUE VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_INTERNAL VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_NOTIFICATION VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS VALID DATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_OCI_REGIONS_UNIQUE VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_PARAM_UNIQUE VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_ATTR$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_ATTR_I1$ VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_FILE$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_FILE_I1$ VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_I1$ VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_PIPELINE_INTERNAL VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_REPO VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_REQUEST VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_REST_API_RESULTS$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_STORE VALID DATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_STORE$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_TASK VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_TASK$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_TASKS VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS$ VALID METADATA LINK Y

C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLASS_UNIQUE VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_TASK_CLEANUP VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_TASK_ID VALID NONE Y

C##CLOUD$SERVICE DBMS_CLOUD_TYPES VALID METADATA LINK Y

64 rows selected.

SQL>

マニュアルの20.3からSSL Walletの作成について記載されていますが、今回はOracle Database 23aiから利用できるsystem:を使うことにします。ウォレットとしてsystem:を指定することで、OSにインストールされているSSL証明書が参照されます。そのため、データベース側でSSL Walletを準備する必要はありません。

20.5のセクションで解説されているACEを設定します。ACEはcatclouduser.sqlの実行で作成されたユーザーC##CLOUD$SERVICEをプリンシパルとして作成します。

ACEはCDB（コンテナとしてはCDB$ROOT）とすべてのPDB（今回はFREEPDB1）に対して、それぞれ作成します。

マニュアルにはSSL WalletのアクセスについてもACEを作成していますが、今回はsystem:の指定を想定しているため、このACEは省略します。

CDB$ROOTに接続し、以下を実行します。

begin
    dbms_network_acl_admin.append_host_ace(
        host => '*',
        ace => xs$ace_type(
            privilege_list => xs$name_list('http','http_proxy'),
            principal_name => 'C##CLOUD$SERVICE',
            principal_type => xs_acl.ptype_db
        )
    );
    commit;
end;
/

SQL> alter session set container = cdb$root;

Session altered.

SQL> begin

dbms_network_acl_admin.append_host_ace(

host => '*',

ace => xs$ace_type(

privilege_list => xs$name_list('http','http_proxy'),

principal_name => 'C##CLOUD$SERVICE',

principal_type => xs_acl.ptype_db

)

);

commit;

end;

/ 2 3 4 5 6 7 8 9 10 11 12

PL/SQL procedure successfully completed.

SQL>

PDBのFREEPDB1へ接続を切り替え、同じスクリプトを実行します。

SQL> alter session set container = freepdb1;

Session altered.

SQL> begin

dbms_network_acl_admin.append_host_ace(

host => '*',

ace => xs$ace_type(

privilege_list => xs$name_list('http','http_proxy'),

principal_name => 'C##CLOUD$SERVICE',

principal_type => xs_acl.ptype_db

)

);

commit;

end;

/ 2 3 4 5 6 7 8 9 10 11 12

PL/SQL procedure successfully completed.

SQL>

20.6で紹介されている検証用のスクリプトを実行します。

以下のコードをファイルverify_dbms_cloud.sqlとして作成し、CDBに接続して実行します。wallet_pathにsystem:を使用するように、マニュアルにあるコードを改変しています。

	define clouduser=C##CLOUD$SERVICE

	-- CUSTOMER SPECIFIC SETUP, NEEDS TO BE PROVIDED BY THE CUSTOMER
	-- - SSL Wallet directory and password
	-- define sslwalletdir=<Set SSL Wallet Directory>
	-- define sslwalletpwd=<Set SSL Wallet password>

	-- In environments w/ a proxy, you need to set the proxy in the verification code
	-- define proxy_uri=<your proxy URI address>

	-- create and run this procedure as owner of the ACLs, which is the future owner
	-- of DBMS_CLOUD

	CREATE OR REPLACE PROCEDURE &clouduser..GET_PAGE(url IN VARCHAR2) AS
	request_context UTL_HTTP.REQUEST_CONTEXT_KEY;
	req UTL_HTTP.REQ;
	resp UTL_HTTP.RESP;
	data VARCHAR2(32767) default null;
	err_num NUMBER default 0;
	err_msg VARCHAR2(4000) default null;

	BEGIN

	--
	-- wallet_pathはsystem:固定.
	--
	-- Create a request context with its wallet and cookie table
	request_context := UTL_HTTP.CREATE_REQUEST_CONTEXT(
	wallet_path => 'system:'
	);

	-- Make a HTTP request using the private wallet and cookie
	-- table in the request context

	-- uncomment if proxy is required
	-- UTL_HTTP.SET_PROXY('&proxy_uri', NULL);

	req := UTL_HTTP.BEGIN_REQUEST(url => url,request_context => request_context);
	resp := UTL_HTTP.GET_RESPONSE(req);

	DBMS_OUTPUT.PUT_LINE('valid response');

	EXCEPTION
	WHEN OTHERS THEN
	err_num := SQLCODE;
	err_msg := SUBSTR(SQLERRM, 1, 3800);
	DBMS_OUTPUT.PUT_LINE('possibly raised PLSQL/SQL error: ' \|\|err_num\|\|' - '\|\|err_msg);

	UTL_HTTP.END_RESPONSE(resp);
	data := UTL_HTTP.GET_DETAILED_SQLERRM ;
	IF data IS NOT NULL THEN
	DBMS_OUTPUT.PUT_LINE('possibly raised HTML error: ' \|\|data);
	END IF;
	END;
	/

	set serveroutput on
	BEGIN
	&clouduser..GET_PAGE('https://objectstorage.eu-frankfurt-1.oraclecloud.com');
	END;
	/

	set serveroutput off
	drop procedure &clouduser..GET_PAGE;

view raw verify_dbms_cloud.sql hosted with ❤ by GitHub

Enter value for proxy_uriとして入力が求められますが、UTL_HTTP.SET_PROXYの呼び出しはコメント・アウトされているため、何を入力しても結果に影響しません。

スクリプトの途中でvalid responseと表示されていれば、パッケージDBMS_CLOUDのインストールの検証は成功したことになります。

bash-4.4$ sqlplus / as sysdba @verify_dbms_cloud.sql

SQL*Plus: Release 23.0.0.0.0 - Production on Thu Mar 27 04:56:04 2025

Version 23.7.0.25.01

Connected to:

Oracle Database 23ai Free Release 23.0.0.0.0 - Develop, Learn, and Run for Free

Version 23.7.0.25.01

old 1: CREATE OR REPLACE PROCEDURE &clouduser..GET_PAGE(url IN VARCHAR2) AS

new 1: CREATE OR REPLACE PROCEDURE C##CLOUD$SERVICE.GET_PAGE(url IN VARCHAR2) AS

Enter value for proxy_uri:

old 23: -- UTL_HTTP.SET_PROXY('&proxy_uri', NULL);

new 23: -- UTL_HTTP.SET_PROXY('', NULL);

Procedure created.

old 2: &clouduser..GET_PAGE('https://objectstorage.eu-frankfurt-1.oraclecloud.com');

new 2: C##CLOUD$SERVICE.GET_PAGE('https://objectstorage.eu-frankfurt-1.oraclecloud.com');

valid response

PL/SQL procedure successfully completed.

old 1: drop procedure &clouduser..GET_PAGE

new 1: drop procedure C##CLOUD$SERVICE.GET_PAGE

Procedure dropped.

SQL>

実際にパッケージを使ってみます。テストに使用するデータベース・ユーザーを、FREEPDB1にtestuserとして作成します。

alter session set container = freepdb1;
create user testuser default tablespace users temporary tablespace temp identified by testuser;
alter user testuser quota unlimited on users;
grant connect, resource, db_developer_role to testuser;
grant execute on dbms_cloud to testuser;
grant execute on dbms_cloud_pipeline to testuser;
grant execute on dbms_cloud_repo to testuser;
grant execute on dbms_cloud_notification to testuser;
grant execute on dbms_cloud_ai to testuser;

SQL> alter session set container = freepdb1;

Session altered.

SQL> create user testuser default tablespace users temporary tablespace temp identified by testuser;

User created.

SQL> alter user testuser quota unlimited on users;

User altered.

SQL> grant connect, resource, db_developer_role to testuser;

Grant succeeded.

SQL> grant execute on dbms_cloud to testuser;

Grant succeeded.

SQL> grant execute on dbms_cloud_pipeline to testuser;

Grant succeeded.

SQL> grant execute on dbms_cloud_repo to testuser;

Grant succeeded.

SQL> grant execute on dbms_cloud_notification to testuser;

Grant succeeded.

SQL> grant execute on dbms_cloud_ai to testuser;

Grant succeeded.

SQL>

テストユーザーtestuserにてHTTPのコールアウトができるように、ACEを追加します。先ほどのスクリプトをプリンシパルをTESTUSERに変更して実行します。

begin
    dbms_network_acl_admin.append_host_ace(
        host => '*',
        ace => xs$ace_type(
            privilege_list => xs$name_list('http','http_proxy'),
            principal_name => 'TESTUSER',
            principal_type => xs_acl.ptype_db
        )
    );
    commit;
end;
/

SQL> begin

dbms_network_acl_admin.append_host_ace(

host => '*',

ace => xs$ace_type(

privilege_list => xs$name_list('http','http_proxy'),

principal_name => 'TESTUSER',

principal_type => xs_acl.ptype_db

)

);

commit;

end;

/ 2 3 4 5 6 7 8 9 10 11 12

PL/SQL procedure successfully completed.

SQL>

以上でTESTUSERの準備は完了です。

PDBのFREEPDB1にユーザーTESTUSERで接続して、Select AIを呼び出してみます。

作業は、オラクルのドキュメントExamples of Using Select AIのExample: Select AI with OpenAIに沿った手順で実施します。OpenAIのAPIキーを取得していることが前提です。

コンテナの中でsqlplusを使うのは面倒です。コンテナのポート1521はホストのポート1521にマップしているため、ホストのmacOSからSQLclで接続して作業します。

% sql testuser/testuser@localhost/freepdb1

SQLcl: 木 3月 27 14:15:00 2025のリリース24.4 Production

接続先:

Oracle Database 23ai Free Release 23.0.0.0.0 - Develop, Learn, and Run for Free

Version 23.7.0.25.01

SQL>

最初に表EMPを作成します。Select AIによるSQLの作成と実行を確認するだけなので、表だけを作成しデータは投入しません。

create table emp (empno number primary key, ename varchar2(80), sal number, comm number);

SQL> create table emp (empno number primary key, ename varchar2(80), sal number, comm number);

Table EMPは作成されました。

SQL>

OpenAIのAPI呼び出しに使用するクリデンシャルを作成します。APIキーは取得済みとします。

begin
  dbms_cloud.create_credential(
    credential_name => 'OPENAI_CRED'
    ,username => 'OPENAI'
    ,password => 'OpenAIのAPIキー'
  );
end;
/

SQL> begin

2 dbms_cloud.create_credential(

3 credential_name => 'OPENAI_CRED'

4 ,username => 'OPENAI'

5 ,password => 'OpenAIのAPIキー'

6 );

7 end;

8* /

PL/SQLプロシージャが正常に完了しました。

SQL>

Select AIのプロファイルを作成します。

begin
  dbms_cloud_ai.create_profile(
    profile_name => 'OPENAI'
    ,attributes => '{"provider": "openai", "credential_name": "OPENAI_CRED",
"object_list": [{ "owner": "TESTUSER", "name": "EMP" }], "conversation": "true" }');
end;
/

SQL> begin

2 dbms_cloud_ai.create_profile(

3 profile_name => 'OPENAI'

4 ,attributes => '{"provider": "openai", "credential_name": "OPENAI_CRED",

5 "object_list": [{ "owner": "TESTUSER", "name": "EMP" }], "conversation": "true" }');

6 end;

7* /

PL/SQLプロシージャが正常に完了しました。

SQL>

作成したプロファイルをセットします。

begin
  dbms_cloud_ai.set_profile('OPENAI');
end;
/

SQL> begin

2 dbms_cloud_ai.set_profile('OPENAI');

3 end;

4* /

PL/SQLプロシージャが正常に完了しました。

SQL>

セットされたプロファイルを確認します。

select dbms_cloud_ai.get_profile() from dual;

SQL> select dbms_cloud_ai.get_profile() from dual;

DBMS_CLOUD_AI.GET_PROFILE()

______________________________

"OPENAI"

SQL>

Select AIを呼び出してSQLを生成します。

select ai showsql how many employees exist;

SQL> select ai showsql how many employees exist;

RESPONSE

___________________________________

SELECT COUNT(*) AS num_employees

FROM "TESTUSER"."EMP"

SQL>

以上で、インストールしたDBMS_CLOUD関連パッケージの動作が確認できました。

Select AIの呼び出しでは不要でしたが、場合によってはHTTPリクエストが発行されるまえ（DBMS_CLOUD.SEND_REQUESTなど）の前にウォレットの設定が必要な場合があるようです。そのようなケースではあらかじめUTL_HTTP.SET_WALLETを実行しておきます。

utl_http.set_wallet('system:');

今回の記事は以上になります。

完

追記

DBMS_CLOUD_REPOは以下の記事で使用しています。ローカルにインストールしたアプリケーションを動かしたところ、概ね動きました。

「GitHubにAPEXアプリをエクスポートする(1) - GitHub側の準備」

DBMS_CLOUD_PIPELINEは以下の記事で動作を確認しています。こちらもローカルで概ね動きました。

「パッケージDBMS_CLOUD_PIPELINEを使用してビューAPEX_WORKSPACE_ACTIVITY_LOGの内容をオフロードする」

追記終了

2025年3月27日木曜日

Oracle Database Free 23ai 23.7にDBMS_CLOUDファミリーのパッケージをインストールする