Webhook JDBCコネクタ構成ガイド

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

このコネクタは、次のデータベースと互換性があります。

• Amazon Redshift
• MariaDB
• MySQL
• PostgreSQL
• SQL Server

バッチ制限

このコネクタは、ベンダーへの大量のデータ転送に対応するため、バッチリクエストを使用します。リクエストは、次の3つのしきい値のいずれかに達するまでキューに格納されます。

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

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します。

• ユーザー名：Tealiumからデータベースにログインするためのユーザー名です。セキュリティ上の理由から、このユーザーには、これらのIPアドレスからの接続のみを許可してください。
• パスワード：指定したユーザー名のパスワードです。
• JDBC URL：接続を確立するための完全修飾JDBC URLです（例：jdbc:postgresql://host:5432/dbname?p1=a&p2=b）。
• 追加プロパティ：接続を確立するときにプロパティとして渡す、カンマ区切りのペアのセットです。たとえば、prop1=a,prop2=bを指定すると、接続は次のように調整されます。

コネクタを構成したら、完了をクリックします。

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

列のデータ型

属性をテーブル列に簡単にマッピングできるように、列名にはデータ型がエンリッチメントされて表示されます。たとえば、VARCHAR型のcustomer_idという列がある場合、マッピングリストには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 を参照します。

例：

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

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

-- Example
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
);

パラメーター