Autonomous DatabaseでSQLトレースを構成するステップを示します。

1. トレース・ファイルをクラウド・オブジェクト・ストレージに格納するためのバケットを作成します。

   SQLトレース・ファイルを保存するには、Autonomous Databaseでサポートされているどのクラウド・オブジェクト・ストアにもバケットを配置します。

   たとえば、Oracle Cloud Infrastructure Object Storageにバケットを作成するには、次を実行します

   1. Oracle Cloud Infrastructure Consoleを開きます。
   2. メニューから「ストレージ」を選択します。
   3. 「Storage」で、「Object StorageとArchive Storage」を選択します。
   4. 「バケットの作成」をクリックします
   5. 「バケットの作成」ページで、バケット名を入力し、「作成」をクリックします。

   Oracle Cloud Infrastructure Object Storageを使用する場合、SQLトレース・ファイルは標準ストレージ層で作成されたバケットでのみサポートされるため、バケットの作成時に必ずストレージ層として「標準」を選択してください。標準オブジェクト・ストレージ層の詳細は、オブジェクト・ストレージの概要を参照してください。

2. DBMS_CLOUD.CREATE_CREDENTIALを使用して、クラウド・オブジェクト・ストレージ・アカウントの資格証明を作成します。

   たとえば:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com', 
       password => 'password'
   );
   END;
   /

   Oracle Cloud Infrastructureの場合、usernameはOracle Cloud Infrastructureのユーザー名です。passwordはOracle Cloud Infrastructureの認証トークンです。詳細は、認証トークンの操作を参照してください。

   クラウド・オブジェクト・ストレージに応じたパラメータとその値の詳細は、CREATE_CREDENTIALプロシージャを参照してください。

3. 初期化パラメータを設定して、SQLトレース・ファイルのバケットのクラウド・オブジェクト・ストレージURLを指定し、Cloud Object Storageにアクセスするための資格証明を指定します。
   1. データベース・プロパティのDEFAULT_LOGGING_BUCKETを設定して、クラウド・オブジェクト・ストレージのロギング・バケットを指定します。

      たとえば、Oracle Cloud Infrastructure Object Storageを使用してバケットを作成する場合:

      SET DEFINE OFF;
      ALTER DATABASE PROPERTY SET 
         DEFAULT_LOGGING_BUCKET = 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucket_name/o/';

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

      リージョンの詳細は、リージョンおよび可用性ドメインを参照してください。

      SQLトレース・ファイルに使用するクラウド・オブジェクト・ストアは、Autonomous Databaseでサポートされている任意のクラウド・オブジェクト・ストアにできます。

   2. データベース・プロパティのDEFAULT_CREDENTIALに、ステップ2で作成した資格証明を設定します。

      資格証明にスキーマ名を含める必要があります。この例では、スキーマはADMINです。

      たとえば:

      ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME';

データベース・セッションのSQLトレースを有効にするステップを示します。

1. (オプション)アプリケーションのクライアント識別子を設定します。このステップはオプションですが、お薦めします。SQLトレースでは、トレース・ファイルがクラウド・オブジェクト・ストアに書き込まれるときに、クライアント識別子がトレース・ファイル名のコンポーネントとして使用されます。

   次に例を示します。

   BEGIN
     DBMS_SESSION.SET_IDENTIFIER('sqlt_test');
   END;
   /

2. (オプション)アプリケーションのモジュール名を設定します。このステップはオプションですが、お薦めします。SQLトレースでは、トレース・ファイルがクラウド・オブジェクト・ストアに書き込まれるときに、モジュール名がトレース・ファイル名のコンポーネントとして使用されます。

   次に例を示します。

   BEGIN
     DBMS_APPLICATION_INFO.SET_MODULE('modname', null);
   END;
   /

3. SQLトレース機能を有効にします。

   ALTER SESSION SET SQL_TRACE = TRUE;

4. ワークロードを実行します。

   このステップには、アプリケーション全体の実行またはアプリケーションの特定の部分の実行が含まれます。データベース・セッションでのワークロードの実行中に、SQLトレース・データが収集されます。

5. SQLトレース無効化

   SQLトレースを無効にすると、セッションで収集されたデータがセッションの表と、SQLトレースの設定時に構成したバケット内のトレース・ファイルに書き込まれます。詳細は、Autonomous DatabaseでのSQLトレースの無効化を参照してください。

Autonomous DatabaseでSQLトレースを無効にするステップを示します。

1. SQLトレース機能を無効にします。

   ALTER SESSION SET SQL_TRACE = FALSE;

2. (オプション)環境の必要に応じて、データベース・プロパティのDEFAULT_LOGGING_BUCKETをリセットして、Cloud Object Storageのロギング・バケットの値をクリアできます。

   たとえば:

   ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';

SQLトレース・ファイルの出力ファイル・ネーミングについて説明し、TKPROFを使用してトレース・ファイル・データを編成および表示するためのコマンドを示します。

sqltrace/sqlt_test/modname/sqltrace_5415_56432.trc

1. オブジェクト・ストアからローカル・システムにトレース・ファイルをコピーします。
2. トレース・ファイルが保存されているディレクトリにナビゲートします。
3. 次の構文を使用して、オペレーティング・システムのプロンプトでTKPROFユーティリティを実行します。

   tkprof filename1 filename2 [waits=yes|no] [sort=option] [print=n]
       [aggregate=yes|no] [insert=filename3] [sys=yes|no] [table=schema.table]
       [explain=user/password] [record=filename4] [width=n]
   

   必要な引数は、入力ファイルと出力ファイルのみです。

4. オンライン・ヘルプを表示するには、引数なしでTKPROFを起動します。

SQLトレースを有効にすると、クラウド・オブジェクト・ストアのトレース・ファイルに保存されたものと同じトレース情報が、トレースが有効になったセッションのSESSION_CLOUD_TRACEビューに表示されます。

DESC SESSION_CLOUD_TRACE

Name       Null? Type
---------- ----- ------------------------------
ROW_NUMBER       NUMBER
TRACE            VARCHAR2(32767)

SELECT trace FROM SESSION_CLOUD_TRACE ORDER BY row_number;