4 Oracle AI DatabaseでのTelemetry Streamingのインストールおよび有効化

この章では、インストール・プロセスと、Oracle AI DatabaseでTelemetry Streamingを有効にする方法について説明します。

トピック:

4.1 インストールの概要

Telemetry Streamingのインストールのタイプとインストールのロードマップについて説明します。

ノート:

Telemetry Streamingは、Oracle AI Database 26aiバージョン23.26.0以降で使用できますが、Oracle AI Databaseにはバンドルされていません。Telemetry Streamingは個別にインストールする必要があります。

基本的なTelemetry Streaming

最小限の設定として、SQL Plusクライアントまたは任意のOracle Call Interface (OCI)クライアントを使用してTelemetry Streamingを実行する場合は、管理ディレクトリからSQLインストール・スクリプトを実行してOracle AI DatabaseでTelemetry Streamingを有効化できます。これにより、基本的なTelemetry Streaming設定に必要なPL/SQLパッケージがインストールされます。スクリプトが正常に実行されると、データベースはTelemetry Streaming対応になります。その後、Telemetry Streaming PL/SQLパッケージを使用して、ユーザー管理、時系列データの取込みおよび問合せを実行できます。

関連項目:

SQLインストール・スクリプトの詳細は、「Oracle AI DatabaseでのTelemetry Streamingの有効化」を参照してください。

エンドツーエンドのTelemetry Streaming

エンドツーエンドのTelemetry Streamingのインストールでは、次のことが可能です:

  • RESTまたはPL/SQLを使用してメトリックを取り込みます。

  • PL/SQLパッケージを介してSQLおよびPromQLを使用したメトリックの問合せ。

表4-1 インストールのロードマップ

インストール手順 必須/オプション 目的

ステップ1: Telemetry StreamingパッケージをインストールするSQLスクリプトを実行します。

必須

SQLまたはOCIクライアントでの基本的な使用のために、Oracle AI DatabaseでTelemetry Streamingを有効にする場合

ステップ2: ORDSのインストール

オプション

REST APIを使用した外部RESTクライアントからのメトリックの取込みまたは問合せの場合

親トピック: Oracle AI DatabaseでのTelemetry Streamingのインストールおよび有効化

4.2 システム要件

この項では、Telemetry Streamingのインストールに必要なソフトウェアおよびデータベース機能を示します。

次の表に、Telemetry Streamingのエンドツーエンド実装に必要なソフトウェアとそのバージョンを示します。

表4-2 Telemetry Streamingのソフトウェア要件

ソフトウェア 目的 バージョン

Oracle AI Database

メトリックを格納および取得するため

Oracle AI Database 26ai、23.26.0以上

ORDS

REST APIの場合

ORDSバージョン23以上

データベース機能

Telemetry Streamingは、既存のOracle機能に基づいて構築されているため、Oracle AI Databaseの次の機能に依存しています。

表4-3 依存関係および前提条件

機能 目的

時間隔パーティション

データ管理と問合せパフォーマンスに役立つデータ編成の場合

圧縮

ストレージ・フットプリントが削減される、しきい値を超えた圧縮データの場合

スケジューラ・ジョブ

データ・ライフサイクル管理の場合

親トピック: Oracle AI DatabaseでのTelemetry Streamingのインストールおよび有効化

4.3 Oracle AI DatabaseでのTelemetry Streamingの有効化

Oracle AI DatabaseでTelemetry Streamingを有効にする方法について説明します。

Oracle AI DatabaseでTelemetry Streamingを有効にするには、$ORACLE_HOME/rdbms/adminディレクトリにある次のファイルのスクリプトを実行する必要があります。

ノート:

REST APIにORDSを使用する場合は、ORDS関連スクリプトを実行する前に、ORDSがインストールされていることを確認してください。

表4-4 Telemetry Streamingのインストール・スクリプト・ファイル

ファイル 機能

telemetry_install_plsql.sql

このスクリプトは、TELEMETRY_DBAユーザーを作成し、その配下のすべてのTelemetry Streaming PL/SQLパッケージをロードします。また、SYSスキーマとTELEMETRY_DBAスキーマの両方に、必要なシノニムとメタデータ表が作成されます。
telemetry_install_ords.sql

このスクリプトは、すべてのORDS関連のTelemetry Streaming PL/SQLパッケージ(prvthtelemetry_ords.plbおよびprvtbtelemetry_ords.plb)をTELEMETRY_DBAにロードします。

PL/SQLでTelemetry Streamingを使用するためのインストール

Telemetry Streamingをインストールして、取込みユーザー、問合せユーザーおよびワークスペース管理ユーザーを含む単純なワークスペースを設定するには、次の手順を実行します。

  1. SYSとして@$ORACLE_HOME/rdbms/admin/telemetry_install_plsql.sqlを実行します(これによりTELEMETRY_DBAが作成され、Telemetry Streamingがインストールされます)。

  2. Telemetry Streamingに使用する表領域を作成します(TMTBSなど)。

  3. ワークスペースに使用する取込みユーザー、問合せユーザーおよび管理ユーザー(wrkspace_ingest_user、wrkspace_query_user、wrkspace_admin_userなど)を作成し、前のステップで作成した表領域(TMTBS)をワークスペースのデフォルト表領域にします。

  4. DBA権限を持つデータベース・ユーザーとして接続して、TMTBS表領域にワークスペースWKSP1を作成します。次の文を実行します。 

    exec TELEMETRY_DBA.dbms_telemetry_workspace.create_workspace('WKSP1','TMTBS');

  5. DBA権限を持つデータベース・ユーザーとして接続し、wrkspace_admin_userをWKSP1の管理者にします。次の文を実行します。 

    exec TELEMETRY_DBA.dbms_telemetry_workspace.enable_workspace_admin('WKSP1','wrkspace_admin_user');

  6. 管理ユーザーwrkspace_admin_userとして接続し、ワークスペースで取込みユーザーと問合せユーザーを有効にします。次の文を実行します。 

    exec dbms_telemetry_admin.enable_workspace_user('WKSP1','wrkspace_ingest_user','ingest')
    exec dbms_telemetry_admin.enable_workspace_user('WKSP1','wrkspace_query_user','query')

前述の手順(「PL/SQLでTelemetry Streamingを使用するためのインストール」)で、ORDSを使用しないTelemetry Streamingのインストールが完了しました。ORDSを使用したTelemetry Streamingのインストールについては、「Oracle REST Data Servicesのインストール」を参照してください。

関連項目:

ワークスペース管理PL/SQLパッケージの詳細は、Oracle AI Database PL/SQLパッケージおよびタイプ・リファレンスのDBMS_TELEMETRY_WORKSPACEおよびDBMS_TELEMETRY_ADMINを参照してください

親トピック: Oracle AI DatabaseでのTelemetry Streamingのインストールおよび有効化

4.3.1 Telemetry StreamingのPDBのパラメータ

Telemetry Streamingのパフォーマンスと効率性を管理するには、Telemetry StreamingのPDBのパラメータを構成します。

インストール時またはインストール後に、ユース・ケースに最適なPDBのパラメータをいくつか構成できます。すべてのパラメータにはそれぞれのデフォルト値があります。

表4-5 Telemetry StreamingのPDBのパラメータ

パラメータ 目的 デフォルト 有効な値

delete_after_duration_hours

この時間より古いデータを削除します

240

1から87600

compress_after_duration_hours

この時間より古いデータを圧縮します

24

1から87600

downsample_after_duration_hours

この時間より古いデータをダウンサンプルします

168

1から87600

downsample_interval_seconds

この間隔(秒単位)でデータをダウンサンプルします

60

1から2600000

downsample_method

その間隔でデータをダウンサンプルするために使用される集計方法

avg

avg、min、max、sum

親トピック: Oracle AI DatabaseでのTelemetry Streamingの有効化

4.4 Oracle REST Data Servicesのインストール

Oracle REST Data Servicesのインストール方法について説明します。

ノート:

Oracle REST Data Services (ORDS)は個別にインストールする必要があります。Telemetry Streamingのインストールには含まれていません。

ORDSを使用すると、外部クライアントがREST APIを使用して、Telemetry Streamingにデータを取り込み、データを問い合せることができます。

ORDSをインストールするには、次のリンクからインストール手順に従います:

Oracle REST Data Servicesのインストールおよび構成

ORDSを使用したTelemetry Streamingの有効化

ORDSのインストール後、SQLスクリプトを実行してREST APIハンドラをインストールし、ORDSでPL/SQLパッケージを使用できるようにします。REST APIインフラストラクチャがTelemetry Streamingにインストールされ、Telemetry Streamingで管理REST API、取込みREST APIのおよび問合せREST APIの使用を開始できます。

関連項目:

ORDSインストール・スクリプトおよびPL/SQLパッケージの詳細は、「Oracle AI DatabaseでのTelemetry Streamingの有効化」を参照してください。

Telemetry Streamingをインストールして、取込みユーザー、問合せユーザーおよびワークスペース管理ユーザーを含む単純なワークスペースをORDSに設定するには、次の手順を実行します。

ワークスペースでORDSを有効にするには、まずORDS DBA (ORDS_DBAなど)を使用してORDSインスタンスを起動して実行する必要があります。その後、次の手順を完了します。

  1. SYSとして@$ORACLE_HOME/rdbms/admin/telemetry_install_ords.sqlを実行します(これにより、Telemetry StreamingにORDS関連パッケージが作成されます)。

  2. ORDS_DBAとして接続し、TELEMETRY_DBA (テレメトリ管理者)およびワークスペース(WKSP1)のORDSスキーマを有効にします。次のコード・ブロックを実行します。 

    1. exec ORDS.enable_schema(
    p_enabled             => TRUE,
    p_schema              => 'TELEMETRY_DBA',
    p_url_mapping_type    => 'BASE_PATH',
    p_url_mapping_pattern => 'TELEMETRY_DBA',
    p_auto_rest_auth      => FALSE
  );

    2. exec ORDS.enable_schema(
    p_enabled             => TRUE,
    p_schema              => 'TM$WKSP1',
    p_url_mapping_type    => 'BASE_PATH',
    p_url_mapping_pattern => 'wksp1',
    p_auto_rest_auth      => FALSE
  );

  3. ワークスペースのORDSハンドラを設定するには、ワークスペース管理者(UC1A)に接続し、Telemetry StreamingのORDSハンドラを有効にします。次の文を実行します。 

    exec dbms_telemetry_admin.enable_workspace_ords('WKSP1');

  4. ワークスペース管理者として接続している状態で、ワークスペースORDS管理資格証明を取得します。次の文を実行します。

    select dbms_telemetry_admin.get_workspace_ords_admin_auth('WKSP1');

関連項目:

ORDSワークスペース・ユーザーの管理およびワークスペース管理のためのREST APIの使用の詳細は、「ORDSワークスペース・ユーザーの管理」および「ワークスペース管理のためのREST APIの使用」を参照してください

親トピック: Oracle AI DatabaseでのTelemetry Streamingのインストールおよび有効化