クラウドデータソースの管理

サポートされているベンダー

クラウドデータソースの構成は、ほとんどのベンダーでほぼ同じです。ベンダー固有の構成の詳細については、以下を参照してください：

クラウドデータソースの作成

クラウドデータソースを作成するには、以下の手順を使用します：

Sources > Data Sources に移動します。
+ Add Data Source をクリックします。
Categories の下で Data Warehouse をクリックし、ベンダーを選択します。
Name フィールドに、使用事例に関連するデータソースの一意の名前を入力します。
Continue をクリックします。

接続の確立

データのインポートを構成する前に、クラウドデータソースへの接続を確立する必要があります。接続は、Tealiumとクラウドデータソースを接続するベンダーの資格情報の再利用可能な構成です。

Connection Configuration 画面で、データソースの名前を確認し、リストから既存の接続を選択するか、+ アイコンをクリックして接続を作成します。

Save をクリックして Connection Configuration 画面に戻り、Establish Connection をクリックします。

接続を正常に確立した後、Table Selection リストからテーブルを選択します。

ベンダーへの接続に関する詳細は、以下を参照してください：

処理の有効化

Enable Processing をオンにして、変更を保存して公開した直後にデータのインポートを開始します。または、構成を完了するまでこの構成をオフにしておき、後でオンにします。

クエリの構成

Query Mode and Configuration 画面で、適切なクエリモードを選択し、必要に応じて SQL WHERE 句を含めて、カスタム条件に一致するレコードのみをインポートします。

クエリモードの選択

クエリモードは、新しい行、変更された行、またはその両方をインポートする方法を決定します。

Timestamp + Incrementing を選択する場合（推奨）、タイムスタンプ列と厳密に増加する列の2つの列を選択する必要があります。
Timestamp または Incrementing を選択する場合、新規および変更された行、または新規行のみを検出するために使用する列を選択する必要があります。

詳細については、クラウドデータソースについてを参照してください。

クエリの構成

Query > Select Columns セクションで、インポートする列を選択します。テーブルまたはビューを変更するには、Previous をクリックして別のテーブルを選択します。
(オプション) カスタム条件を追加するには、SQL WHERE 句を含めます。
WHERE 句は複数のテーブルからのサブクエリをサポートしていません。複数のテーブルからデータをインポートするには、ビューを作成し、データソース構成でそのビューを選択します。
Test Query をクリックして SQL クエリを検証し、結果をプレビューします。

列のマッピング

列マッピングテーブルを使用して、事前に構成された列ラベルをイベント属性にマッピングするか、手動で列ラベルを入力してマッピングします。イベント属性にマッピングされていない列は無視されます。

各列ラベルに対して、リストから対応するイベント属性を選択します。

訪問IDのマッピング

AudienceStreamでクラウドデータソースを使用するには、列を訪問ID属性にマッピングします。訪問IDを表す列を選択し、対応する訪問ID属性にマッピングします。

AudienceStreamでの訪問IDマッピングはデフォルトで有効になっています。訪問IDマッピングを無効にすると、訪問のスティッチングにエラーが発生する可能性があります。詳細については、Tealiumデータソースを使用した訪問識別を参照してください。

まとめ

この最終ステップでは、要約を表示し、必要に応じて修正を行い、プロファイルを保存して公開します。構成を編集するには、変更を加えたいステップに戻るために Previous をクリックします。

イベント属性と訪問IDのマッピングを表示します。
Finish をクリックしてデータソースを作成し、構成画面を終了します。新しいデータソースは Data Sources ダッシュボードにリストされます。
Save/Publish をクリックして変更を保存し、公開します。

処理された行とエラー

インポート活動を確認するには、Data Sources に移動し、データソースを展開します。

ステータス

クラウドデータソースを構成した後、以下のいずれかのステータスが表示される場合があります：

ステータス	説明
Failed	接続エラーが発生しました。たとえば、認証失敗などで、エラーが解決されるまでインポートは停止されます。インポート中の行レベルのエラーはこのステータスを引き起こさず、データソースが Running のままでログに記録されます。
Inactive	データソースは作成されましたが、オンにされたことがなく、他のステータスに移行されませんでした。
Initializing	コネクタは初めて起動するか、Stopped 状態から再開します。これは Running または Scheduled に移行する前の一時的な状態です。
Running	コネクタはアクティブにクエリを実行し、データをインポートしています。
Scheduled	次のインポートがスケジュールされています。この状態は Initializing または Running の後に続くことがあります。
Stopped	データソースは以前に有効化されましたが、現在はオフになっています。有効にするまでデータのインポートは行われません。
Unassigned	タスクはクラウドワーカーに割り当てられるのを待っています。

テスト構成

データソース、セグメント、またはアクティベーションを有効にする前に、データソースとクエリをテストすることをお勧めします。ただし、テストを実行すると、セグメントがアクティブになる可能性があり、有効なアクションがトリガーされたり、下流システムに影響を与える可能性があります。意図しない結果を防ぐために、コネクターと機能を無効にし、テストレコードを制限し、受信者と調整してください。

データソース構成をテストするには、以下の手順を使用します：

データソース画面でデータソースを見つけ、編集アイコンをクリックします。
データソースウィンドウの右上隅にあるアクションボタンをクリックし、エンドツーエンドテストをクリックします。
出力を受け取る方法を選択します：
- 新しいトレースセッション：出力は新しいトレースセッションで表示され、最大10レコードまでです。このオプションは、エンドツーエンドの検証とログの詳細を確認するのに最適です。
- 既存のトレースセッション：出力は既に開始されているトレースセッションで表示されます。トレースIDを入力し、トレースに参加をクリックします。
- ダイレクト出力：出力の生結果が画面に表示されます。データレコードにトレースIDは追加されず、トレースは利用できません。このオプションは、クエリと属性マッピングを迅速に確認するのに最適です。
テストのために処理する行数を選択します。最大行数は10です。
テストクエリの下で、テストに含めるテーブルの列を選択します。リストから列を削除するには、列のXをクリックします。少なくとも1つの列を選択する必要があります。
From Tableの下で、クエリを実行するテーブルを選択します。Select Columnsボックスがテーブルの列で更新されます。
Whereの下で、テーブルで実行するSQLクエリを入力します。
Check QueryをクリックしてSQLを検証し、必要なフィールドが構成されていることを確認します。
結果はQuery Result Previewタブの下のテーブルに表示されます：
Start Testをクリックして構成テストを開始します。

右サイドバーには、テストの完了までの時間を推定するプログレスバーと、テストがエラーに遭遇した場合に知らせるステータスメッセージが表示されます。

テストが完了すると、結果が表示されます。

トレースでテストの実行を見たい場合は、トレースに参加をクリックします。
テストが失敗した場合、次のことができます：
- テスト構成の編集をクリックして構成を変更します。
- テストを再試行をクリックして現在の構成を再度実行します。

処理開始の構成

データソースは、クエリが開始される日付または増分値の位置を追跡します。この位置をリセットまたは手動で構成して、ビューまたはテーブルのどこからクエリを開始するかを制御できます。

たとえば、最近のメーリングリストのアクティベーションにエラーが含まれており、100レコードが処理された場合、現在の増分位置は342です。メールアクティベーションを修正した後、そのレコードを再処理するには、開始点を242に構成します。データソースを再起動すると、その位置からレコードのクエリが開始され、修正されたメールが送信されます。

次の条件が真の場合にのみ、開始点を管理できます：

現在のプロファイルが公開されています。
クエリモードがタイムスタンプ + 増分 (推奨)、タイムスタンプ、または増分です。完全な再同期クエリモードでは、開始点を管理することはできません。
データソースが停止しています。
- データソースの状態が実行中、スケジュールされている、または失敗している場合、開始点を編集することはできません。現在の開始点に関する情報のみが利用可能です。
- 状態が初期化中、非アクティブ、または接続エラーがある場合、開始点は利用できません。

データソースの開始点を管理するには、次の手順を使用します：

Data Sources画面でデータソースを見つけ、編集アイコンをクリックします。
データソースの詳細ウィンドウの右上隅にあるアクションボタンをクリックし、処理開始の構成をクリックします。
利用可能な開始点の方法は処理開始タイムスタンプと増分開始点です。クエリモードによって利用可能な開始点が決まります。
タイムスタンプ列の下で、タイムスタンプを表すテーブルの列を選択します。
新しいタイムスタンプの下で、データのインポート時に使用する開始位置として日付と時間を選択します。
- 新しいタイムスタンプは過去の日時でなければなりません。未来の日時は使用できません。
- 現在のタイムスタンプフィールドには、現在使用されている開始位置が表示されます。
増分列の下で、テーブルに追加される各行の増分値を表す列を選択します。
新しい増分の下で、データのインポート時に開始点を構成するために使用する数値を入力します。
- 新しい開始点は正の整数でなければなりません。
- 現在の開始点フィールドには、開始点として使用される現在の開始位置が表示されます。

処理開始の変更を検証をクリックして、新しい開始点からインポートされるデータのプレビューを表示します。テーブルにはサンプル行が表示され、開始点を調整した後に処理される行数の見積もりも提供されます。

完了をクリックして新しい開始点の構成を確認します。キャンセルをクリックして変更を破棄します。開始点を変更した後、データソースを再起動します。