DBMS_CLOUD_ADMINサブプログラム

この項では、Autonomous AI Databaseで提供されるDBMS_CLOUD_ADMINサブプログラムについて説明します.

ATTACH_FILE_SYSTEMプロシージャ

このプロシージャは、データベースにファイル・システムをアタッチします。

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMプロシージャは、データベースにファイル・システムをアタッチし、ファイル・システムに関する情報をDBA_CLOUD_FILE_SYSTEMSビューに格納します。

構文

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name         IN VARCHAR2,
    file_system_location     IN VARCHAR2,
    directory_name           IN VARCHAR2,
    description              IN VARCHAR2 DEFAULT NULL,
    params                   IN CLOB DEFAULT NULL
);

パラメータ

例

NFSv3ファイル・システムにアタッチします。

BEGIN
   DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'FSS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'FSS_DIR',
    description           => 'Source NFS for sales data'
  );
END;
/

NFSv4ファイル・システムにアタッチします。

BEGIN
   DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'FSS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'FSS_DIR',
    description           => 'Source NFS for sales data',
    params                => JSON_OBJECT('nfs_version' value 4)
);
END;
/

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMを使用してファイル・システムをアタッチするには、データベース内のディレクトリ・オブジェクトに対するWRITE権限が必要です。

• DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMプロシージャでは、プライベート・エンドポイントが有効になっているデータベースでのみプライベート・ファイル・ストレージ・サービスをアタッチできます。

  詳細は、OCIファイル・ストレージ・サービスおよびプライベート・エンドポイントを使用したネットワーク・アクセスの構成を参照してください。

• DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMプロシージャは、顧客の仮想クラウド・ネットワーク(VCN)上のネットワーク・ファイル・システムのホスト名を検索します。エラー"ORA-20000: Mounting NFS fails"は、その場所に指定したホスト名が見つからない場合に返されます。

• Oracle Cloud Infrastructure File Storageでは、NFSv3を使用して共有します

• Oracle Cloud Infrastructure File Storage以外のシステムにアタッチする場合、このプロシージャはNFSv3およびNFSv4をサポートします

• NFSv3を使用する接続されたNFSサーバーがあり、NFSバージョンがNFSサーバーでNFSv4に更新される場合は、DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMを実行してからDBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMを実行する必要があります(nfs_versionを4に設定したparamsパラメータを使用)。これにより、一致プロトコルでNFSがアタッチされ、Autonomous AI DatabaseがNFSv4サーバーにアクセスできるようになります。デタッチしてから再アタッチしないと、NFSサーバーにアクセスできなくなり、"Protocol not supported"などのエラーが表示される場合があります。

CANCEL_WORKLOAD_CAPTUREプロシージャ

このプロシージャは、データベースで進行中のワークロード取得を取り消します。

構文

このプロシージャは、現在のワークロード取得を取り消し、リフレッシュ可能クローンでリフレッシュを有効にします。

DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;

例

BEGIN
   DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;
END;
/

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

CREATE_DATABASE_LINKプロシージャ

このプロシージャは、APIをコールするスキーマ内のターゲット・データベースへのデータベース・リンクを作成します。

オーバーロードされたフォームでは、次のものがサポートされます。

• gateway_paramsパラメータを使用すると、サポートされている非OracleデータベースへのリンクであるOracle管理の異機種間接続を使用して、データベース・リンクを作成できます。

• rac_hostnamesパラメータを使用すると、プライベート・エンドポイントのAutonomous AIデータベースからターゲットOracle RACデータベースへのデータベース・リンクを作成できます。この場合、rac_hostnamesパラメータを使用して、ターゲットOracle RACデータベースの1つ以上の個別のノードのホスト名を指定します。

構文

DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
       db_link_name         IN VARCHAR2,
       hostname             IN VARCHAR2,
       port                 IN NUMBER,
       service_name         IN VARCHAR2,
       ssl_server_cert_dn   IN VARCHAR2 DEFAULT,
       credential_name      IN VARCHAR2 DEFAULT,
       directory_name       IN VARCHAR2 DEFAULT,
       gateway_link         IN BOOLEAN DEFAULT,
       public_link          IN BOOLEAN DEFAULT,
       private_target       IN BOOLEAN DEFAULT
       gateway_params       IN CLOB DEFAULT);

DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
       db_link_name         IN VARCHAR2,
       rac_hostnames        IN CLOB,
       port                 IN NUMBER,
       service_name         IN VARCHAR2,
       ssl_server_cert_dn   IN VARCHAR2 DEFAULT,
       credential_name      IN VARCHAR2 DEFAULT,
       directory_name       IN VARCHAR2 DEFAULT,
       gateway_link         IN BOOLEAN DEFAULT,
       public_link          IN BOOLEAN DEFAULT,
       private_target       IN BOOLEAN DEFAULT);

パラメータ

'["sales1-svr1.domain", "sales1-svr2.domain", "sales1-svr3.domain"]'

gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'enable_ssl' value true)

使用上のノート

• gateway_paramsパラメータを指定すると、db_type値によっては、追加のgateway_paramsパラメータがサポートされます。

  db_type	追加のgateway_params値
  azure	db_type値がazureの場合、NTLM/AD認証をサポートする2つのオプション・パラメータauth_methodおよびdomainがあります。 NTLMv2が構成されている場合は、auth_method=10を設定し、domainをWindowsドメイン値に設定します。 Azure Active Directoryパスワードを使用するには、auth_method=13を設定します。auth_method=13を使用してOracleオンプレミス・データベースにアクセスしないでください。 詳細は、Microsoft SQL Server認証方式を参照してください。
  google_analytics	db_typeがgoogle_analyticsの場合、指定する資格証明はGoogle OAuth資格証明(gcp_oauth2)である必要があります。詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。
  google_bigquery	db_typeがgoogle_bigqueryの場合、指定する資格証明はGoogle OAuth資格証明である必要があります(gcp_oauth2)詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください)。 db_typeがgoogle_bigqueryの場合、パラメータprojectは有効です。このパラメータは、google_bigqueryのプロジェクト名を指定します。これは必須です。 SELECTをGoogle BigQueryとともに使用するときに指定する表名は、引用符で囲む必要があります。たとえば: SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK
  google_drive	db_type google_driveの場合、DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKで指定する資格証明は、gcp_oauth2値(client_id、client_secretおよびrefresh_token)を指定したparamsパラメータを使用して、OAuthタイプの資格証明である必要があります。 Googleドライブに接続してデータを取得するには、ゲートウェイ・パラメータdirectory_nameおよびfile_nameを指定する必要があります。これらのパラメータは、JSONレスポンスをリレーショナル・モデルにマップするモデル・ファイル(自動RESTファイル)を指定します。モデル・ファイルは、JSONレスポンスを処理するためのエンドポイント、表マッピングおよびHTTPレスポンス・コードを指定します。詳細は、モデル・ファイル構文およびモデル・ファイルの例を参照してください。 gateway_paramsパラメータをdb_type google_driveとともに使用する場合は、gateway_paramsパラメータdb_typeに値'google_drive'を指定し、directory_nameおよびfile_nameパラメータをOAuthタイプの資格証明とともに指定する必要があります。 directory_nameパラメータは、REST構成ファイルを含むディレクトリを指定します。このディレクトリは、次のように作成できます。 create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR'; 自動RESTファイルを取得して、指定したディレクトリにダウンロードします。たとえば: exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); file_name値を、ダウンロードした自動RESTファイルの名前であるgoogle_drive.restに設定します。その後、OAuth 2.0でREST構成ファイルを使用できます。
  hive	db_typeがhiveの場合、パラメータhttp_pathは有効です。このパラメータは、必要に応じて、Hiveインスタンスに接続するためのHttpPath値を指定します。
  salesforce	db_typeがsalesforceの場合、パラメータsecurity_tokenは有効です。セキュリティ・トークンは、大/小文字が区別される英数字コードです。Salesforceにアクセスするには、security_token値を指定する必要があります。たとえば: gateway_params => JSON_OBJECT( 'db_type' value 'salesforce', 'security_token' value 'security_token_value' ) 詳細は、セキュリティ・トークンのリセットを参照してください。
  servicenow	ServiceNowに接続してデータを取得するには、ゲートウェイ・パラメータdirectory_nameおよびfile_nameを指定する必要があります。これらのパラメータは、JSONレスポンスをリレーショナル・モデルにマップするモデル・ファイル(REST構成ファイル)を指定します。モデル・ファイルは、JSONレスポンスを処理するためのエンドポイント、表マッピングおよびHTTPレスポンス・コードを指定します。詳細は、モデル・ファイル構文およびモデル・ファイルの例を参照してください。 gateway_paramsパラメータをdb_type servicenowとともに使用すると、次の2つのオプションがサポートされます。 基本認証: gateway_paramsパラメータdb_typeに値'servicenow'を指定し、ユーザー名/パスワード・タイプの資格証明とともにdirectory_nameおよびfile_nameパラメータを指定する必要があります。 OAuth 2.0認証: gateway_paramsパラメータdb_typeに値'servicenow'を指定し、directory_name、file_nameおよびtoken_uriパラメータをOAuthタイプの資格証明とともに指定する必要があります。 directory_nameパラメータは、ServiceNow REST構成ファイルを使用してディレクトリを指定します。このディレクトリは、次のように作成できます。 create or replace directory servicenow_dir as 'SERVICENOW_DIR'; ServiceNow REST構成ファイルを取得して、指定したディレクトリにダウンロードします。たとえば: exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); file_name値を、ダウンロードしたREST構成ファイルservicenow.restの名前に設定します。 次に、ServiceNow REST構成ファイルと基本認証またはOAuth2.0のいずれかを使用できます。 その後、Basic認証またはOAuth2.0のいずれかでServiceNow REST構成ファイルを使用できます。サンプルは、「HETEROGENEOUS_CONNECTIVITY_INFOビュー」を参照してください。
  sharepoint	gateway_paramsパラメータをdb_type sharepointとともに使用する場合は、auth_uri、scope、service_urlおよびtoken_uriの値も指定します。 db_type sharepointの場合、DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKで指定する資格証明は、gcp_oauth2値が指定されたparamsパラメータ(client_id、client_secretおよびrefresh_token)を使用したOAuthタイプの資格証明である必要があります。詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。tenant_id.sharepoint.com/.default offline_accessのrefresh_tokenを生成します。詳細は、スコープの決定およびOAuth 2.0認証を参照してください。 db_type sharepointのgateway_paramsの値を設定します。 auth_uri: Azureからauth_uriを設定します。詳細は、「アプリケーション・クライアント情報およびエンドポイントの取得」を参照してください。 scope: スコープを設定します。詳細は、接続オプションの説明を参照してください。 service_url: service_urlを設定します。詳細は、Service URLを参照してください。 token_uri: Azureからtoken_uriを取得します。詳細は、「アプリケーション・クライアント情報およびエンドポイントの取得」を参照してください。
  snowflake	db_typeがSNOWFLAKEの場合、オプションのパラメータrole、schemaおよびwarehouseは有効です。これらの値は、デフォルト以外の異なるスキーマ、ロールまたはウェアハウスの値を指定します。たとえば: gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
  youtube	Youtubeに接続してデータを取得するには、ゲートウェイ・パラメータdirectory_nameおよびfile_nameを指定する必要があります。これらのパラメータは、JSONレスポンスをリレーショナル・モデルにマップするモデル・ファイル(REST構成ファイル)を指定します。モデル・ファイルは、JSONレスポンスを処理するためのエンドポイント、表マッピングおよびHTTPレスポンス・コードを指定します。詳細は、モデル・ファイル構文およびモデル・ファイルの例を参照してください。 gateway_paramsパラメータをdb_type youtubeとともに使用する場合、指定する資格証明はGoogle OAuth資格証明(gcp_oauth2)である必要があります。詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。 OAuth 2.0認証: gateway_paramsパラメータdb_typeに値youtubeを指定し、directory_nameおよびfile_nameパラメータをOAuthタイプの資格証明とともに指定する必要があります。 directory_nameパラメータは、ServiceNow REST構成ファイルを使用してディレクトリを指定します。このディレクトリは、次のように作成できます。 create or replace directory youtube_dir as 'YOUTUBE_DIR'; ServiceNow REST構成ファイルを取得して、指定したディレクトリにダウンロードします。たとえば: exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); file_name値を、ダウンロードしたREST構成ファイルyoutube.restの名前に設定します。 その後、OAuth2.0でServiceNow REST構成ファイルを使用できます。サンプルは、「HETEROGENEOUS_CONNECTIVITY_INFOビュー」を参照してください。

• ADMIN以外のユーザーでDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKを実行するには、そのユーザーにEXECUTEおよびCREATE DATABASE LINK権限を付与する必要があります。たとえば、ADMINとして次のコマンドを実行して、adb_userに権限を付与します:

  GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO adb_user;
  GRANT CREATE DATABASE LINK TO adb_user;

  また、ADMINスキーマ以外のスキーマ(たとえば、adb_userという名前のスキーマ)にデータベース・リンクを作成する場合、adb_userスキーマは、DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKで使用する資格証明を所有している必要があります。

• directory_nameパラメータで指定されたディレクトリごとに有効なウォレット・ファイルは1つのみです。ウォレット・ファイル用に選択したディレクトリに一度にアップロードできるのは1つのcwallet.ssoだけです。つまり、ディレクトリ内のcwallet.ssoでは、そのディレクトリのウォレットが有効なデータベースへのデータベース・リンクのみ作成できます。データベース・リンクで複数のcwallet.ssoファイルを使用するには、追加のディレクトリを作成し、各cwallet.ssoを異なるディレクトリに配置する必要があります。

  ディレクトリの作成の詳細は、「Autonomous AI Databaseでのディレクトリの作成」を参照してください。

• Autonomous AI Databaseへのデータベース・リンクを作成するには、ソース・データベース(非Autonomous AI Database)でGLOBAL_NAMESをFALSEに設定します。

   SQL> ALTER SYSTEM SET GLOBAL_NAMES = FALSE;
  
   System altered.
  
   SQL> SHOW PARAMETER GLOBAL_NAMES
    NAME                     TYPE        VALUE
   ----------------------   ----------- -----------
    global_names             boolean     FALSE

• private_targetパラメータがTRUEの場合、hostnameパラメータはVCN内のプライベート・ホストを指定します。

例

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DB_LINK_CRED',
     username => 'adb_user',
     password => 'password');
  DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
     db_link_name => 'SALESLINK',
     hostname => 'adb.eu-frankfurt-1.oraclecloud.com',
     port => '1522',
     service_name => 'example_medium.adb.example.oraclecloud.com',
     ssl_server_cert_dn => 'CN=adb.example.oraclecloud.com,OU=Oracle BMCS FRANKFURT,O=Oracle Corporation,L=Redwood City,ST=California,C=US',
     credential_name => 'DB_LINK_CRED');
END;
/

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'AWS_REDSHIFT_LINK_CRED',
    username => 'NICK',
    password => 'password'
  );
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
          db_link_name => 'AWSREDSHIFT_LINK',
          hostname => 'example.com',
          port => '5439',
          service_name => 'example_service_name',
          ssl_server_cert_dn => NULL,
          credential_name => 'AWS_REDSHIFT_LINK_CRED',
          gateway_params => JSON_OBJECT('db_type'  value 'awsredshift'));
END;
/

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'PRIVATE_ENDPOINT_CRED',
    username => 'db_user',
    password => 'password'
  );
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
          db_link_name => 'PRIVATE_ENDPOINT_DB_LINK',
          hostname => 'exampleHostname',
          port => '1521',
          service_name => 'exampleServiceName',
          credential_name => 'PRIVATE_ENDPOINT_CRED',
          ssl_server_cert_dn => NULL,
          directory_name => NULL,
          private_target => TRUE);
END;
/

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'GOOGLE_BIGQUERY_CRED',
    params => JSON_OBJECT( 'gcp_oauth2' value JSON_OBJECT(
          'client_id' value 'client_id',
          'client_secret' value 'client_secret',
          'refresh_token' value 'refresh_token' )));

DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
          db_link_name => 'GOOGLE_BIGQUERY_LINK',
          hostname => 'example.com',
          port => '443',
          service_name => 'example_service_name',
          credential_name => 'GOOGLE_BIGQUERY_CRED',
          gateway_params => JSON_OBJECT(
                     'db_type' value 'google_bigquery',
                     'project' value 'project_name1' ));
END;
/

Google BigQueryまたはGoogle AnalyticsでSELECTを使用する場合に指定する表名は、引用符で囲む必要があります。次に例を示します。

SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK

プライベート・エンドポイント上のターゲットOracle RACデータベースでrac_hostnamesパラメータを使用します。

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DB_LINK_CRED1',
     username => 'adb_user',
     password => 'password');
      DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
     db_link_name => 'SALESLINK',
     rac_hostnames => '["sales1-svr1.example.adb.us-ashburn-1.oraclecloud.com",
                        "sales1-svr2.example.adb.us-ashburn-1.oraclecloud.com",
                        "sales1-svr3.example.adb.us-ashburn-1.oraclecloud.com"]',
     port => '1522',
     service_name => 'example_high.adb.oraclecloud.com',
     ssl_server_cert_dn => 'CN=adb.example.oraclecloud.com,OU=Oracle BMCS FRANKFURT,O=Oracle Corporation,L=Redwood City,ST=California,C=US',
     credential_name => 'DB_LINK_CRED1',
     directory_name => 'EXAMPLE_WALLET_DIR',
     private_target => TRUE);
END;
/

DETACH_FILE_SYSTEMプロシージャ

このプロシージャは、データベースからファイル・システムをデタッチします。

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャは、データベースからファイル・システムをデタッチします。また、DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャは、ファイル・システムに関する情報もDBA_CLOUD_FILE_SYSTEMSビューから削除します。

構文

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM(
    file_system_name         IN VARCHAR2
);

パラメータ

例

BEGIN
   DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM (
    file_system_name      => 'FSS'
  );
END;
/

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャを使用してディレクトリからファイル・システムをデタッチするには、データベース内のディレクトリ・オブジェクトに対するWRITE権限が必要です。

• DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャでは、プライベート・エンドポイントが有効になっているデータベースでのみプライベート・ファイル・ストレージ・サービスをデタッチできます。

  詳細は、OCIファイル・ストレージ・サービスおよびプライベート・エンドポイントを使用したネットワーク・アクセスの構成を参照してください。

• DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャは、顧客の仮想クラウド・ネットワーク(VCN)上のネットワーク・ファイル・システムのホスト名を検索します。エラー"ORA-20000: Mounting NFS fails"は、その場所に指定したホスト名が見つからない場合に返されます。

DISABLE_APP_CONTプロシージャ

このプロシージャは、Autonomous AI Database内の特定のサービス名に関連付けられたセッションのデータベース・アプリケーション・コンティニュイティを有効化します。

構文

DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
    service_name      IN VARCHAR2);

パラメータ

使用上のノート

アプリケーション・コンティニュイティの詳細は、「アプリケーション・コンティニュイティの概要」を参照してください。

例

BEGIN
    DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
        service_name => 'nv123abc1_adb1_high.adb.oraclecloud.com' );
END;
/

次のように値を検証します。

SELECT name, failover_type FROM DBA_SERVICES;

NAME                                                    FAILOVER_TYPE
------------------------------------------------------- --------------
nv123abc1_adb1_high.adb.oraclecloud.com

DISABLE_EXTERNAL_AUTHENTICATIONプロシージャ

データベースの外部認証スキームを使用したユーザー認証を無効にします。

構文

DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;

例外

例

BEGIN
   DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;
END;
/

PL/SQL procedure successfully completed.

DISABLE_FEATUREプロシージャ

このプロシージャは、Autonomous AI Databaseインスタンスで指定された機能を無効にします。

構文

DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name    IN  VARCHAR2);

パラメータ

例

BEGIN
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'ORAMTS');
END;
/

BEGIN
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'AUTO_DST_UPGRADE');
END;
/

BEGIN
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA');
END;
/

BEGIN
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'OWM');
END;
/

BEGIN
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'WORKLOAD_AUTO_REPLAY');
END;
/

使用上のノート

• Autonomous AI DatabaseインスタンスのOraMTS、AUTO_DST_UPGRADE、AUTO_DST_UPGRADE_EXCL_DATA、OWMまたはWORKLOAD_AUTO_REPLAY機能を無効にするには、ADMINユーザーとしてログインするか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• AUTO_DST_UPGRADEとAUTO_DST_UPGRADE_EXCL_DATAの両方が無効になっている場合、新しいタイム・ゾーン・バージョンが使用可能な場合、Autonomous AI Databaseインスタンスは、使用可能な最新のタイム・ゾーン・ファイルを使用するようにアップグレードされません。

• dba_cloud_configを問い合せて、AUTO_DST_UPGRADEが無効になっていることを確認します。

SELECT param_name, param_value FROM dba_cloud_config WHERE
       LOWER(param_name) = 'auto_dst_upgrade';

0 rows selected.

• dba_cloud_configを問い合せて、AUTO_DST_UPGRADE_EXCL_DATAが無効になっていることを確認します。

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade_excl_data';
  
  0 rows selected.

DISABLE_OPERATOR_ACCESSプロシージャ

この手順では、Autonomous AI Databaseインスタンスに対するクラウド・オペレータ・アクセスがただちに取り消されます。

構文

DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;

例

BEGIN
    DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;
END;
/

DISABLE_PRINCIPAL_AUTHプロシージャ

このプロシージャは、Autonomous AI Database上の指定されたプロバイダのプリンシパル・ベースの認証を取り消し、ADMINユーザーまたは指定したユーザーに適用されます。

構文

DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH(
       provider    IN VARCHAR2,
       username    IN VARCHAR2 DEFAULT 'ADMIN' );

パラメータ

使用上のノート

• プロバイダ値がAZUREで、usernameがADMINの場合、このプロシージャはAutonomous AI DatabaseでのAzureサービス・プリンシパル・ベースの認証を無効化し、Autonomous AI Databaseインスタンス上のAzureアプリケーションを削除します。

• プロバイダ値がAZUREで、usernameがADMINユーザー以外のユーザーである場合、プロシージャは指定されたユーザーから権限を取り消します。Azureサービス・プリンシパルを使用できるようになっているADMINユーザーおよびその他のユーザーは、引き続きADMIN.AZURE$PAを使用でき、Autonomous AI Databaseインスタンス用に作成されたアプリケーションはインスタンス上に残ります。

例

BEGIN
     DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH(
       provider => 'AZURE',
       username => 'SCOTT');
END;
/

BEGIN
     DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH(
       provider => 'GCP');
END;
/

DISABLE_RESOURCE_PRINCIPALプロシージャ

データベースまたは指定したスキーマのリソース・プリンシパル資格証明を無効にします。

構文

DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2);

パラメータ

例外

使用上のノート

• リソース・プリンシパルは、リフレッシュ可能なクローンでは使用できません。

• DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPALをコールする前に、動的グループの動的グループおよびポリシーを設定する必要があります。

  ポリシーの作成、動的グループの作成、およびルールの作成の詳細は、次を参照してください。

  • リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセス

  • 動的グループの管理

  • ポリシーの管理

• DBA_CREDENTIALSまたはALL_TAB_PRIVSのいずれかのビューを問い合せて、リソース・プリンシパル資格証明が有効になっていることを確認します。

  たとえば、ADMINユーザーとしてビューDBA_CREDENTIALSを問い合せます。

SELECT owner, credential_name FROM dba_credentials
        WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN';

OWNER  CREDENTIAL_NAME
-----  ----------------------
ADMIN  OCI$RESOURCE_PRINCIPAL

たとえば、ADMIN以外のユーザーとして、ビューALL_TAB_PRIVSを問い合せます。

SELECT grantee, table_name, grantor, FROM ALL_TAB_PRIVS
          WHERE  grantee = 'ADB_USER';

GRANTEE   TABLE_NAME GRANTOR
--------- -------------------------------------
ADB_USER  OCI$RESOURCE_PRINCIPAL ADMIN

例

EXEC DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL();

PL/SQL procedure successfully completed.

SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL';

No rows selected.

DROP_DATABASE_LINKプロシージャ

このプロシージャは、データベース・リンクを削除します。

構文

DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK(
        db_link_name      IN VARCHAR2,
        public_link       IN BOOLEAN DEFAULT);

パラメータ

例

BEGIN
    DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK(
        db_link_name => 'SALESLINK' );
END;
/

BEGIN
    DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK(
        db_link_name => 'SALESLINK'
        public_link => TRUE );
END;
/

使用上のノート

データベース・リンクの使用が完了したら、DBMS_CLOUD_ADMIN.DROP_DATABASE_LINKを実行して、Oracleデータベースのセキュリティを確保し、格納されているウォレット・ファイルを削除します。次に例を示します。

• オブジェクト・ストア内のウォレット・ファイルを削除します。

• DBMS_CLOUD.DELETE_FILEを使用して、ウォレット・ファイルをdata_pump_dirディレクトリから、またはウォレット・ファイルがアップロードされたユーザー定義ディレクトリから削除します。

ENABLE_APP_CONTプロシージャ

このプロシージャは、Autonomous AI Database内の特定のサービス名に関連付けられたセッションのデータベース・アプリケーション・コンティニュイティを有効にします。

構文

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

パラメータ

使用上のノート

アプリケーション・コンティニュイティの詳細は、「アプリケーション・コンティニュイティの概要」を参照してください。

例

BEGIN
    DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
        service_name => 'nvthp2ht_adb1_high.adb.oraclecloud.com'
    );
END;
/

次のように値を検証します。

SELECT name, failover_type FROM DBA_SERVICES;

NAME                                                    FAILOVER_TYPE
------------------------------------------------------- -------------
nvthp2ht_adb1_high.adb.oraclecloud.com                 TRANSACTION

ENABLE_AWS_ARNプロシージャ

この手順では、Autonomous AI DatabaseインスタンスがAmazon Resource Names (ARN)を使用してAWSリソースにアクセスできます。

構文

DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN(
       username     IN VARCHAR2 DEFAULT NULL,
       grant_option IN BOOLEAN DEFAULT FALSE);

パラメータ

例

BEGIN
    DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN(
        username => 'adb_user');
END;
/

使用上のノート

• プロシージャDBMS_CLOUD_ADMIN.ENABLE_AWS_ARNを実行するには、ADMINユーザーである必要があります。

詳細は、「Amazonリソース・ネーム(ARN)を使用したAWSリソースへのアクセス」を参照してください。

ENABLE_EXTERNAL_AUTHENTICATIONプロシージャ

ユーザーが外部認証スキームを使用してデータベースにログインできるようにします。

構文

DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
   type         IN VARCHAR2,
   force        IN BOOLEAN DEFAULT FALSE,
   params       IN CLOB DEFAULT NULL
);

パラメータ

例外

使用上のノート

• type OCI_IAMでは、Autonomous AI Databaseインスタンスでリソース・プリンシパルが有効になっていない場合、このルーチンはDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPALでリソース・プリンシパルを有効にします。

• このプロシージャは、システム・パラメータIDENTITY_PROVIDER_TYPEおよびIDENTITY_PROVIDER_CONFIGを、Oracle Cloud Infrastructure Identity and Access Managementの認証および認可を使用してインスタンスにアクセスするために必要なユーザーに設定します。

例

OCI_IAM認証の有効化

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'OCI_IAM',
     force=> TRUE );
END;
/

PL/SQL procedure successfully completed.

Microsoft Active DirectoryのCMU認証の有効化

params JSON引数を使用して、CMU構成ファイルを含むディレクトリ名を渡します。

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'CMU',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'CMU_DIR'); // CMU_DIR directory object already exists
END;
/

PL/SQL procedure successfully completed.

params JSON引数を使用して、CMU構成ファイルを含むオブジェクト・ストレージの場所を指す場所URIを渡します。

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
       type     => 'CMU',
       params   => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
                               'credential_name' value 'my_credential_name')
   );
END;
/

PL/SQL procedure successfully completed.

Azure AD認証の有効化

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'AZURE_AD',
     force => TRUE,
     params   => JSON_OBJECT( 'tenant_id' VALUE '....',
                              'application_id' VALUE '...',
                              'application_id_uri' VALUE '.....' ));
END;
/

PL/SQL procedure successfully completed.

Kerberos認証の有効化

params JSON引数を使用して、Kerberos構成ファイルを含むディレクトリ名を渡します。

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR'); // KERBEROS_DIR directory object already exists
END;
/

PL/SQL procedure successfully completed.

params JSON引数を使用して、Kerberos構成ファイルを含むオブジェクト・ストレージの場所を指すロケーションURIを渡します:

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
                           'credential_name' value 'my_credential_name');
END;
/

params JSON引数にkerberos_service_nameを使用してサービス名を渡します。

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR', // KERBEROS_DIR directory object already exists
                           'kerberos_service_name' value 'oracle' ));
END;
/

自律型AIデータベース・インスタンスでKerberosを有効にした後、次の問合せを使用してKerberosサービス名を表示します:

SELECT SYS_CONTEXT('USERENV','KERBEROS_SERVICE_NAME') FROM DUAL;

ENABLE_FEATUREプロシージャ

このプロシージャは、Autonomous AI Databaseインスタンスで指定した機能を有効にします。

構文

DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
    feature_name     IN VARCHAR2,
    params           IN  CLOB   DEFAULT NULL);

パラメータ

JAVAVM機能を有効化する例

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'JAVAVM' );
END;
/

自動DST機能を有効にする例

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'AUTO_DST_UPGRADE' );
END;
/

自動DST EXCLデータ機能を有効にする例

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA' );
END;
/

OraMTS機能を有効にする例

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'ORAMTS',
        params       => JSON_OBJECT('location_uri' VALUE 'https://mymtsserver.mycorp.com')
   );
END;
/

OWM機能を有効にする例

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'OWM' );
END;
/

ワークロードの自動リプレイ機能を有効にする例

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'WORKLOAD_AUTO_REPLAY',
        params       => JSON_OBJECT('target_db_ocid' VALUE 'OCID1.autonomousdatabase.REGION..ID1', 'capture_duration' VALUE 120, 'capture_day' VALUE 'MONDAY', 'capture_time' VALUE '15:00'));
END;
/

エラー値がORA-20000: Invalid argument for target_db_ocidの場合、指定したOCIDがリフレッシュ可能クローンではない可能性があります。この場合、OCIDにリフレッシュ可能クローンの値を指定する必要があります。

使用上のノート

• DBMS_CLOUD_ADMIN.ENABLE_FEATUREを実行するには、ADMINユーザーとしてログインするか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• feature_name値'JAVAVM'を指定してDBMS_CLOUD_ADMIN.ENABLE_FEATUREを実行した後、Autonomous AI Databaseインスタンスを再起動してOracle Javaをインストールする必要があります。

  Autonomous AI Databaseインスタンスを再起動すると、データベースのオープン後しばらくの間、Javaのインストールが続行されます。

  Javaインストールのステータスの確認の詳細は、「Oracle Javaバージョンの確認」を参照してください。

• feature_name値'OWM'を指定してDBMS_CLOUD_ADMIN.ENABLE_FEATUREを実行した後、Autonomous AI Databaseインスタンスを再起動してOracle Workspace Managerを有効にする必要があります。Oracle。

• データベースのAUTO_DST_UPGRADE、AUTO_DST_UPGRADE_EXCL_DATA、ORAMTS、JAVAVM、OWMまたはWORKLOAD_AUTO_REPLAY機能を有効にするには、ADMINユーザーとしてログインするか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• デフォルトでは、AUTO_DST_UPGRADEとAUTO_DST_UPGRADE_EXCL_DATAの両方が無効になっています。これらのオプションのどちらか一方を有効にできますが、両方を有効にすることはできません。

• AUTO_DST_UPGRADEを有効にした後、次回Autonomous AI Databaseインスタンスを再起動または停止してから起動すると、インスタンスは、使用可能な最新のタイムゾーン・ファイルを使用するようにアップグレードされます。AUTO_DST_UPGRADEを有効にした後、新しいタイム・ゾーン・ファイルが使用可能になると、インスタンスは、機能が無効になるまで、再起動または停止および起動のたびに、使用可能な最新バージョンに引き続きアップグレードされます。

dba_cloud_configを問い合せて、AUTO_DST_UPGRADEが有効になっていることを確認します。

  SELECT param_name, param_value FROM dba_cloud_config WHERE
      LOWER(param_name) = 'auto_dst_upgrade';

    PARAM_NAME       PARAM_VALUE
    ---------------- --------------
    auto_dst_upgrade enabled

• AUTO_DST_UPGRADE_EXCL_DATAを有効にすると、Autonomous AI Databaseインスタンスのアップグレードで、使用可能な最新のタイムゾーン・ファイルが使用されます。この機能を有効にすると、後続のすべてのメンテナンス・ウィンドウが、使用可能な最新のタイムゾーン・バージョンを使用するようにインスタンスをアップグレードします。この機能により、データベースのタイムゾーン・ファイルがアップグレードされることが保証されます(AUTO_DST_UPGRADE_EXCL_DATAを有効にしても、影響を受ける行は更新されません)。

dba_cloud_configを問い合せて、AUTO_DST_UPGRADE_EXCL_DATAが有効になっていることを確認します。

SELECT param_name, param_value FROM dba_cloud_config WHERE
       LOWER(param_name) = 'auto_dst_upgrade_excl_data';

PARAM_NAME                    PARAM_VALUE

--------------------------    -----------
auto_dst_upgrade_excl_data    enabled

ENABLE_OPERATOR_ACCESSプロシージャ

Oracle Cloud OperationsはAutonomous AI Databaseインスタンスにアクセスせず、デフォルトでアクセスは許可されません。問題のトラブルシューティングまたは軽減のためにアクセスが必要な場合、クラウド・オペレータがデータベース・スキーマに限られた時間アクセスすることを許可できます。

構文

DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
    auth_duration    IN  NUMBER  DEFAULT 1
);

パラメータ

例

Autonomous AI Databaseでクラウド・オペレータのアクセスを12時間有効にする例:

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
       auth_duration => 12 );
END;
/

Autonomous AI Databaseで無制限の期間クラウド・オペレータ・アクセスを有効にする例:

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
       auth_duration => 'UNLIMITED' );
END;
/

使用上のノート

• ORA-20000: Operator access is already enabledは、オペレータ・アクセスがすでに付与されていることを示します。この場合は、次の2つのオプションがあります。

  • オペレータ・アクセスが期限切れになるまで待機してから、DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESSを使用してオペレータ・アクセスを再度付与します

  • DISABLE_OPERATOR_ACCESSプロシージャを使用してオペレータ・アクセスを明示的に無効にします。

• DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESSは、クラウド・オペレータへのアクセスのみを許可し、他のユーザーのアクセスは有効にしません。Cloud Operatorによって実行されるすべての操作は、ビューDBA_OPERATOR_ACCESSに格納されます。詳細は、Oracle Cloud Infrastructure Operations Actionsの表示を参照してください。

• プロシージャDBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESSを実行して、クラウド・オペレータがデータベース・スキーマにアクセスできるようにします。つまり、Oracle Cloud Supportでサービス・リクエストを申請し、Oracle Cloud Operatorsがデータベース・スキーマにアクセスする必要がある場合は、DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESSを実行してオペレータ・アクセスも有効にする必要があります。

ENABLE_PRINCIPAL_AUTHプロシージャ

このプロシージャは、指定されたプロバイダのAutonomous AI Databaseでのプリンシパル認証を有効にし、ADMINユーザーまたは指定したユーザーに適用されます。

構文

DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(
       provider    IN VARCHAR2,
       username    IN VARCHAR2 DEFAULT 'ADMIN',
       params      IN CLOB DEFAULT NULL);

パラメータ

使用上のノート

• providerパラメータがAZUREの場合、次の場合にparamsパラメータにazure_tenantidを含める必要があります。

  • DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTHが初めて呼び出されたとき。

  • providerパラメータAZUREおよびusername ADMINを使用してDBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTHがコールされた後、DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTHが初めてコールされた場合。

• providerパラメータがAWSの場合:

  • DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTHを実行してAutonomous AI DatabaseインスタンスでARNを有効にすると、AWS$ARNという名前の資格証明を入力として取得するDBMS_CLOUD APIで使用できます。

例

BEGIN
     DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(
       provider => 'AZURE',
       username => 'SCOTT',
       params   => JSON_OBJECT('azure_tenantid' value 'azure_tenantid'));
END;
/

BEGIN
     DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(
     provider => 'GCP',
     username => 'SCOTT',
     params => JSON_OBJECT(
         'grant_option' value 'TRUE' ));
END;
/

BEGIN
     DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(
     provider => 'AWS',
     username => 'SCOTT',
     params => JSON_OBJECT(
         'aws_role_arn' value 'arn:aws:iam::123456:role/AWS_ROLE_ARN',
          'external_id_type' value 'TENANT_OCID'));
END;
/

ENABLE_RESOURCE_PRINCIPALプロシージャ

データベースまたは指定したスキーマのリソース・プリンシパル資格証明を有効にします。このプロシージャは、資格証明OCI$RESOURCE_PRINCIPALを作成します。

構文

DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2,
   grant_option     IN BOOLEAN DEFAULT FALSE);

パラメータ

例外

使用上のノート

• データベース・ユーザー・スキーマに対してusernameを使用してDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPALをコールする前に、ADMIN usernameまたは引数なしでDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPALをコールする必要があります。

• DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPALをコールする前に、動的グループの動的グループおよびポリシーを設定する必要があります。

  ポリシー、動的グループの作成およびルールの作成の詳細は、次を参照してください。

  • リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセス

  • 動的グループの管理

  • ポリシーの管理

• DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPALを使用したリソース・プリンシパルの有効化は、1回かぎりの操作です。リソース・プリンシパルを無効にするためにDBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPALを実行しないかぎり、リソース・プリンシパルを再度有効にする必要はありません。

• リソース・プリンシパルは、リフレッシュ可能なクローンでは使用できません。

例

EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

PL/SQL procedure successfully completed.

SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL';

OWNER    CREDENTIAL_NAME
-------  ---------------
ADMIN    OCI$RESOURCE_PRINCIPAL

FINISH_WORKLOAD_CAPTUREプロシージャ

このプロシージャは、現在のワークロード取得を終了し、後続のワークロード取得リクエストをデータベースに停止し、取得ファイルをオブジェクト・ストレージにアップロードします。

例

BEGIN
    DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE
END;
/

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• durationパラメータをSTART_WORKLOAD_CAPTUREに渡すと、指定した時間に達すると取得が終了します。ただし、FINISH_WORKLOAD_CAPTUREをコールすると、(durationパラメータで指定された時間より前に)ワークロードの取得が停止されます。

  DBA_CAPTURE_REPLAY_STATUSビューを問い合せて、終了ワークロードのステータスを確認できます。詳細は、「DBA_CAPTURE_REPLAY_STATUSビュー」を参照してください。

ノート

ノート:
取得ファイルをダウンロードするには、FINISH_WORKLOAD_CAPTUREの完了およびオブジェクト・ストレージ・リンクに関する通知を受け取るには、情報イベントcom.oraclecloud.databaseservice.autonomous.database.informationをサブスクライブする必要があります。このPAR URLはイベントのcaptureDownloadURLフィールドに含まれており、生成日から7日間有効です。詳細は、Autonomous AI Databaseの情報イベントを参照してください。

PREPARE_REPLAYプロシージャ

PREPARE_REPLAYプロシージャは、リフレッシュ可能クローンをリプレイ用に準備します。

パラメータ

構文

DBMS_CLOUD_ADMIN.PREPARE_REPLAY(
        capture_name IN VARCHAR2);

例

BEGIN
    DBMS_CLOUD_ADMIN.PREPARE_REPLAY
      capture_name => 'cap_test1');
END;
/

この例では、リフレッシュ可能クローンが、capture_nameパラメータで指定されたワークロードをリプレイするように準備します。これには、取得開始時間まで取得してから切断が含まれます。

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

PURGE_FLASHBACK_ARCHIVEプロシージャ

このプロシージャにより、ADMINユーザーはフラッシュバック・データ・アーカイブから履歴データをパージできます。フラッシュバック・データ・アーカイブflashback_archiveからすべての履歴データをパージするか、タイムスタンプまたはシステム変更番号に基づいて選択的なデータをパージできます。

構文

  DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE(
    scope      IN VARCHAR2,
    before_scn IN INTEGER DEFAULT NULL,
    before_ts  IN TIMESTAMP DEFAULT NULL);

パラメータ

例

BEGIN
	DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE(
           scope => 'ALL'); // Purge all historical data from Flashback Data Archive flashback_archive
END;
/

REPLAY_WORKLOADプロシージャ

このプロシージャは、Autonomous AI Databaseインスタンスでワークロード・リプレイを開始します。オーバーロードされたフォームでは、Autonomous AI Databaseインスタンス、オンプレミス・データベースまたはその他のクラウド・サービス・データベースから取得ファイルをリプレイできます。

構文

DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        capture_name                  IN VARCHAR2,
        replay_name                   IN VARCHAR2 DEFAULT NULL,
        capture_source_tenancy_ocid   IN VARCHAR2 DEFAULT NULL,
        capture_source_db_name        IN VARCHAR2 DEFAULT NULL);

DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        location_uri      IN VARCHAR2,
        credential_name   IN VARCHAR2 DEFAULT NULL,
        synchronization   IN BOOLEAN  DEFAULT TRUE,
        process_capture   IN BOOLEAN  DEFAULT TRUE);

パラメータ

Autonomous AI Databaseインスタンス上のオンプレミス・データベースからワークロードをリプレイする例:

BEGIN
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        location_uri    => 'https://objectstorage.us-phoenix-
1.oraclecloud.com/n/namespace-string/b/bucketname/o',
        credential_name => 'CRED_TEST',
        synchronization => TRUE,
        process_capture => TRUE);
END;
/

この例を実行すると、次のようになります。

• location_uriで指定されたオブジェクト・ストレージの場所から取得ファイルをダウンロードし、process_captureパラメータ値に基づいて取得ファイルを処理します。

• synchronizationパラメータ値に基づいて取得されたワークロードをリプレイします。

この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

オブジェクト・ストレージの詳細は、Oracle Cloud Infrastructure Object Storageへの移動とバケットの作成を参照してください。

オブジェクト・ストレージへのファイルのアップロードの詳細は、Oracle Cloud Infrastructure Object Storeバケットへのファイルのアップロードを参照してください。

このステップで使用するcredential_nameは、オブジェクト・ストアの資格証明です。

リソース・プリンシパル資格証明を有効にした場合、Oracle Cloud Infrastructureオブジェクト・ストアにアクセスするための資格証明を作成する必要はありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。

別のAutonomous AI DatabaseでAutonomous AI Databaseインスタンスのワークロードをリプレイする例

BEGIN
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        capture_name => 'CAP_TEST1');
END;
/

この例を実行すると、次のようになります。

• 現在のAutonomous AI Databaseインスタンスを切断します。

• オブジェクト・ストレージから取得ファイルをダウンロードします。

• 取得されたワークロードをリプレイします。

• リプレイ後にリプレイ・レポートをアップロードします。

別の自律型AIデータベース上のオンプレミスまたは他のCloud Serviceデータベースからワークロードをリプレイするための使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• リプレイを開始する前に、ワークロード取得ファイルを含むcapおよびcapfilesサブディレクトリをオブジェクト記憶域の場所にアップロードする必要があります。

別のAutonomous AI DatabaseでAutonomous AI Databaseインスタンスからワークロードをリプレイするための使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• リプレイ・ファイルは、自動的にzipファイルとしてオブジェクト・ストアにアップロードされます。

• DBA_CAPTURE_REPLAY_STATUSビューを問い合せて、ワークロードのリプレイ・ステータスを確認できます。

  詳細は、「DBA_CAPTURE_REPLAY_STATUSビュー」を参照してください。

ノート

ノート:リプレイ・レポートをダウンロードするには、情報イベントcom.oraclecloud.databaseservice.autonomous.database.informationをサブスクライブし、REPLAY_WORKLOADの開始と完了およびオブジェクト・ストレージ・リンクについて通知を受ける必要があります。このPAR URLはイベントのreplayDownloadURLフィールドに含まれており、生成日から7日間有効です。詳細は、Autonomous AI Databaseの情報イベントを参照してください。

SET_FLASHBACK_ARCHIVE_RETENTIONプロシージャ

このプロシージャを使用すると、ADMINユーザーはフラッシュバック・データ・アーカイブflashback_archiveの保存期間を変更できます。

構文

DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION (
    retention_days INTEGER);

パラメータ

例

BEGIN
     DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION(
           retention_days => 90); // sets the retention time to 90 days
END;
/

START_WORKLOAD_CAPTUREプロシージャ

このプロシージャは、Autonomous AI Databaseインスタンスでワークロードの取得を開始します。

構文

DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name  IN VARCHAR2,
        duration      IN NUMBER   DEFAULT NULL);

パラメータ

例

BEGIN
  DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name => 'test');
END;
/

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• ワークロードに対するシステム変更の影響を測定するには、取得およびリプレイ・システムが同じ論理状態にあることを確認する必要があります。

• ワークロードの取得を開始する前に、リフレッシュ可能クローンのプロビジョニングを検討して、リプレイの開始点が同じになるようにする必要があります。

ノート

ノート: START_WORKLOAD_CAPTUREの開始時に通知を受けるには、情報イベントcom.oraclecloud.databaseservice.autonomous.database.informationをサブスクライブする必要があります。詳細は、Autonomous AI Databaseの情報イベントを参照してください。

START_LIVE_WORKLOAD_REPLAYプロシージャ

この手順では、Autonomous AI Databaseインスタンスでライブ・ワークロード取得リプレイを開始します。

構文

DBMS_CLOUD_ADMIN.START_LIVE_WORKLOAD_REPLAY(
        capture_replay_name  IN VARCHAR2,
        target_db_ocid       IN VARCHAR2,
        capture_duration     IN NUMBER DEFAULT NULL,
        reconnect_target     IN BOOLEAN DEFAULT TRUE
 );

パラメータ

例

BEGIN
  DBMS_CLOUD_ADMIN.START_LIVE_WORKLOAD_REPLAY(
        capture_replay_name => 'LiveReplayTest',
        target_db_ocid      => 'OCID1.autonomousdatabase.REGION..ID1',
        capture_duration    => 120,
        reconnect_target    => VALUE TRUE
 );
END;
/

使用上のノート

• このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

• ワークロードに対するシステム変更の影響を測定するには、取得およびリプレイ・システムが同じ論理状態にあることを確認する必要があります。

• ライブ・ワークロード取得リプレイを開始する前に、リフレッシュ可能クローンのプロビジョニングを検討して、リプレイの開始ポイントが同じになるようにする必要があります。

パージ変換済_STMTS

DBMS_CLOUD_ADMIN.PURGE_CONVERTED_STMTSプロシージャは、他のOracleデータベースからAutonomous AI Databaseに移行するときに、変換されたSQL文のエントリをDBA_CONVERTED_STATEMENTSビューから削除します。

構文

PROCEDURE DBMS_CLOUD_ADMIN.PURGE_CONVERTED_STMTS(
  retention_date IN TIMESTAMP DEFAULT NULL
);

パラメータ

例

BEGIN
  DBMS_CLOUD_ADMIN.PURGE_CONVERTED_STMTS(
    retention_date => SYSTIMESTAMP - INTERVAL '1' DAY
  );
END;
/

MASK_SQL_TEXTプロシージャ

DBMS_CLOUD_ADMIN.MASK_SQL_TEXTプロシージャは、SQLテキスト・マスキングを有効または無効にします。

構文

DBMS_CLOUD_ADMIN.MASK_SQL_TEXT(
   enable IN BOOLEAN,
   scope  IN VARCHAR2
);

パラメータ

例

BEGIN
  DBMS_CLOUD_ADMIN.MASK_SQL_TEXT(
    enable => FALSE,
    scope  => 'SYSTEM');
END;
/