206.3.1 INGEST_METRICSファンクション

このファンクションを使用すると、ワークスペース内のユーザーが、単一のメトリック・サンプルとしてデータをOracle AI Database Telemetry Streamingに取り込めます。

INGEST_METRICSファンクションは、metric_name、metric_tags (VARCHARとしてのJSON)、metric_valueおよびmetric_time (エポック秒)を使用して単一サンプルの取込みを実行します。

構文

function ingest_metrics(
         metric_name        IN VARCHAR2, 
         metric_tags        IN VARCHAR2,
         metric_value       IN NUMBER,
         metric_time_epoch  IN NUMBER)
return clob;

パラメータ

表206-2 INGEST_METRICSファンクションのパラメータ

パラメータ	説明
metric_name	metric_nameは、長さが512以下の、有効なVARCHAR2である必要があります。 metric_nameは、Prometheusメトリックに似たセマンティクスに従っている必要があります。 参照: metric_nameの詳細は、『Oracle AI Database Telemetry Streaming開発者ガイド』のデータ形式およびネーミング規則
metric_tags	メトリック・タグは、長さが4000未満の、有効なVARCHAR2である必要があります。これは、有効なJSONであることを保証するためにIS JSONチェック制約と(STRICT)修飾子が追加されて、JSONとしてデータベースに格納されます。そのため、それぞれの書式設定をタグの入力に適用する必要があります。 参照: Oracle DatabaseでのJSONの使用の詳細は、JSON開発者ガイドのOracle DatabaseのJSON。
metric_value	時系列のポイント・イン・タイム(PIT)値
metric_time_epoch	エポックからの時間(秒)