Webhook JDBCコネクタ構成ガイド

HTTP APIエンドポイントにデータを送信するためのWebhookを使用する方法については、Webhookコネクタについてを参照してください。

バッチ制限

このコネクタはバッチリクエストを使用して、ベンダーへの大量データ転送をサポートします。リクエストは以下のいずれかの閾値に達するまでキューに入れられます：

• 最大リクエスト数：1,000
• 最古のリクエストからの最大時間：60分
• リクエストの最大サイズ：100 MB

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

• ユーザー名：Tealiumからデータベースにログインするためのユーザー名。セキュリティ上の理由から、このユーザーはこれらのIPアドレスからのみ接続を許可します。

• パスワード：提供されたユーザー名のパスワード。

• JDBC URL：接続を確立するための完全修飾JDBC URL（例：jdbc:postgresql://host:5432/dbname?p1=a&p2=b）。

• 追加プロパティ：接続を確立する際に渡すプロパティのコンマ区切りペアのセット。例えば、prop1=a,prop2=bは接続に次の調整を行います：

  props.setProperty("prop1", "a");
  props.setProperty("prop2", "b");
  Connection conn = DriverManager.getConnection(url, props);
  

列データ型

属性をテーブルの列にマッピングしやすくするために、列はそのデータ型を名前に追加して表示されます。例えば、customer_idという名前の列がVARCHAR型の場合、マッピングリストにはcustomer_id//VARCHARと表示されます。

バッチ構成

バッチ処理をサポートするすべてのアクションは、以下のパラメータをサポートします：

アクション

すべてのイベントデータを送信

このアクションを使用して、イベントのJSONオブジェクト全体を単一のテーブル列に送信します。

詳細については、Webhook アクションとパラメータを参照してください。

パラメータ

カスタムイベントデータを送信

このアクションを使用して、特定のイベント属性を特定のテーブル列に送信します。

パラメータ

すべてのログイベントを送信

詳細については、コネクターエラーログを参照してください。

パラメータ

ログイベントを送信

詳細については、コネクターエラーログを参照してください。

パラメータ

ログイベントリソース属性

これらのフィールドは、テレメトリが記録されるエンティティに関する情報をキャプチャします。

ログイベントHTTP属性

これらのフィールドは、ログシステム内のHTTPリクエストとレスポンスを記録します。

HTTP配列全体を単一の列にマッピングする場合は、http属性をマップします。ターゲット列がVARIANT型の場合は、生の配列が送信されます。それ以外の場合は、文字列に変換されます。

ログイベント結果属性

これらのフィールドは、操作の結果を記録し、成功したかエラーが発生したかを詳述します。

ログイベントその他の属性

これらのフィールドは、ログされたイベントに関する追加のメタデータを提供します。

すべての訪問データを送信

このアクションを使用して、訪問のJSONオブジェクト全体を単一のテーブル列に送信します。

詳細については、Webhook アクションとパラメータを参照してください。

パラメータ

カスタム訪問データを送信

このアクションを使用して、特定の訪問属性を特定のテーブル列に送信します。

パラメータ

カスタムクエリを実行

このアクションを使用してカスタムSQLステートメントを実行します。

許可されているのはINSERT、UPDATE、またはMERGEステートメントのみで、SELECTサブクエリを含むことができます。同じクエリ内に複数のINSERT、UPDATE、またはMERGEステートメントを含めるとエラーが発生します。

この機能を使用するには、属性を名前付きプレースホルダーにマッピングし、SQL内で:MY_PLACEHOLDER形式を使用して参照します。たとえば、ブール属性を:my_bool_paramというプレースホルダーにマッピングした場合、その値をマッピングされた属性の値で置き換えたい場所で:my_bool_paramを参照します。

例：

-- 例
INSERT INTO redshift_table
(col1, col2) VALUES (:col1Value, :col2Value)

-- 例
UPDATE redshift_table
SET col1 = :col1Value, col2 = :col2Value
WHERE col3 = :col3Value

-- 例
UPDATE redshift_table
SET col2 = (
  SELECT new_col2 FROM source_table WHERE source_table.col1 = redshift_table.col1
)
WHERE EXISTS (
  SELECT 1 FROM source_table WHERE source_table.col1 LIKE :col1Value
);

パラメーター