Tableau Prep ヘルプ

注: バージョン 2020.4 以降では、Tableau Server および Tableau Cloud でフローの作成と編集も行えるようになりました。このトピックの内容は、特に記載がない限り、すべてのプラットフォームに適用されます。

作業内容はフローのどの時点でも手動で保存することができます。または、Web 上でフローを作成または編集する際に Tableau で自動的に保存されるようにすることもできます。Web 上でフローを操作する場合、いくつかの相違点があります。

Web 上でのフローの作成の詳細については、Tableau Server(新しいウィンドウでリンクが開く) および Tableau Cloud(新しいウィンドウでリンクが開く) ヘルプの「Web 上の Tableau Prep」を参照してください。

データを最新の状態に保つために、フローを Tableau Prep Builder やコマンド ラインから手動で実行することができます。また、Tableau Server または Tableau Cloud でパブリッシュされたフローを手動で実行するか、スケジュールに従って実行することもできます。フローの実行について詳しくは、「Tableau Server または Tableau Cloud へのフローのパブリッシュ」を参照してください。

フローの保存

Tableau Prep Builder では、追加の操作を実行する前に、フローを保存して作業内容をバックアップできます。フローは Tableau Prep フロー (.tfl) ファイル形式で保存されます。

Tableau Desktop でワークブックをパッケージして共有するのと同様に、ローカル ファイル (Excel、テキスト ファイル、Tableau 抽出) をフローと一緒にパッケージして他のユーザーに共有することもできます。ローカル ファイルのみをフローと一緒にパッケージできます。データベース接続のデータなどは含まれません。

Web オーサリングでは、ローカルファイルは自動的にフローと一緒にパッケージ化されます。ファイルへの直接接続はまだサポートされていません。

パッケージド フローを保存すると、フローはパッケージド Tableau Flow ファイル (.tflx) として保存されます。

• フローを保存するには、トップ メニューから [ファイル] > [保存] を選択します。

• Tableau Prep Builder では、データ ファイルをフローと一緒にパッケージ化するには、トップ メニューから次のいずれかを実行します。

  • [ファイル] > [パッケージド フローのエクスポート] を選択します。

  • [ファイル] > [名前を付けて保存] を選択します。その後、[名前を付けて保存] ダイアログで、[種類を指定して保存] ドロップダウン メニューより [パッケージド Tableau Flow ファイル] を選択します。

Web 上でフローを自動的に保存する

Tableau Server バージョン 2020.4 以降でサポートされています。

Web 上でフローを作成または編集する場合、フローに変更を加えると (データ ソースに接続してステップを追加するなど)、その作業は数秒ごとに下書きとして保存されるため、作業が失われることはありません。

フローは現在サインインしているサーバーにのみ保存できます。1 つのサーバーでフローの下書きを作成して、別のサーバーに保存またはパブリッシュすることはできません。フローをサーバー上の別のプロジェクトにパブリッシュする場合は、[ファイル] > [Publish As (名前を付けてパブリッシュ)] オプションを使用して、ダイアログからプロジェクトを選択します。

フローの下書きは、パブリッシュしてサーバー上のプロジェクトにアクセスするパーミッションを持つすべてのユーザーが使用できるようになるまで、自分以外のユーザーには表示できません。ステータスが下書きになっているフローには、下書きのバッジが付けられているため、進行中のフローは簡単に見つけることができます。フローがパブリッシュされていない場合は、下書きのバッジの横の [Never Published (パブリッシュされていない)] バッジが表示されます。

フローをパブリッシュした後にフローを編集してもう一度パブリッシュすると、新しいバージョンが作成されます。[リビジョン履歴] ダイアログでフローのバージョンのリストを確認できます。[検索] ページで、[アクション] メニューをクリックし、[リビジョン履歴] を選択します。

リビジョン履歴の管理の詳細については、Tableau Desktop ヘルプの「コンテンツのリビジョンの操作」(新しいウィンドウでリンクが開く)を参照してください。

注: 自動保存は既定で有効化されています。管理者がサイトで自動保存を無効にすることは可能ですが、推奨されてません。自動保存をオフにするには、Tableau Server REST API メソッドの「サイトの更新」を使用して、flowAutoSaveEnabled 属性を false に設定します。詳細については、「Tableau Server REST API サイトのメソッド: サイトの更新(新しいウィンドウでリンクが開く)」を参照してください。

ファイルの自動復元

Tableau Prep Builder バージョン 2020.3.3 以降でサポートされています。

既定では、Tableau Prep Builder でアプリケーションがフリーズまたはクラッシュした場合、開いているフローの下書きが自動的に保存されます。フローの下書きは マイ Tableau Prep リポジトリの [Recovered Flow (復元されたフロー)] フォルダーに保存されます。次回アプリケーションを開くと、ダイアログに復元されたフローの選択可能なリストが表示されます。復元されたフローを開いて中断した場所から続行するか、必要がない場合は復元されたフロー ファイルを削除することができます。

注: [Recovered Flow (復元されたフロー)] フォルダーの中にフローを復元した場合、このダイアログは、そのフォルダーが空になるまでアプリケーションを開くたびに表示されます。

この機能を有効にしたくない場合、管理者としてインストール中またはインストール後にオフにすることができます。この機能をオフにする方法については、Tableau Desktop および Tableau Prep の導入ガイドにある「ファイルの復元をオフにする(新しいウィンドウでリンクが開く)」を参照してください。

Tableau Desktop でフロー出力を表示する

注: このオプションは Web 上では使用できません。

データのクリーニングを行う際に、進捗を Tableau Desktop で表示して確認したいと思うことがあるかもしれません。Tableau Desktop でフローを開くと、Tableau Prep Builder が永続的な Tableau .hyper ファイルと Tableau データ ソース (.tds) ファイルを作成します。ファイルは Tableau リポジトリのデータ ソース ファイルに保存されるので、いつでもデータを試すことができます。

Tableau Desktop でフローを開くと、選択したステップまで、操作が適用された状態のフローの作業中のデータ サンプルが表示されます。

注: データを試すことはできますが、Tableau ではデータのサンプルのみが表示されるため、ワークブックをパッケージ化されたワークブック (.twbx) として保存することはできません。Tableau でデータを操作する準備ができたら、フローの出力ステップを作成して出力をファイルに保存するか、パブリッシュされたデータ ソースとして保存してから、Tableau の完全なデータ ソースに接続します。

Tableau Desktop でデータ サンプルを表示するには、次の手順を実行します。

1. データを表示するステップを右クリックし、コンテキスト メニュ－から [Tableau Desktop でプレビュー] を選択します。

   

2. Tableau Desktop が [シート] タブで開きます。

データ抽出ファイルとパブリッシュされたデータ ソースを作成する

重要: Tableau Prep Builder バージョン 2020.3.1 以降では、Tableau データ抽出 (.tde) ファイルがフロー出力タイプとして使用できなくなりました。フロー実行の失敗を回避するには、フロー出力を (.tde) ファイルから Hyper 抽出 (.hyper) ファイルに変換します。Tableau Server または Tableau Cloud にパブリッシュされたフローは、Tableau Prep Builder にダウンロードして、ファイルの出力タイプを変更する必要があります。

フロー出力を生成するには、フローを実行します。フローを実行すると、変更内容がデータ セット全体に適用されます。フローを実行すると、Tableau データ ソース (.tds) および Tableau データ抽出 (.hyper) ファイルが作成されます。

注: データ抽出やパブリッシュされたデータ ソースは、Tableau Server バージョン 10.0 以降、または Tableau Cloud にパブリッシュできます。

Tableau Prep Builder

フロー出力から抽出ファイルを作成して、Tableau Desktop で使用したり、データをサード パーティに共有したりできます。抽出ファイルは以下の形式で作成できます。

• Hyper 抽出 (.hyper): これは最新の Tableau 抽出ファイル タイプですが、Tableau Desktop または Tableau Server バージョン 10.5 以降でのみ使用できます。

• コンマ区切り値 (.csv): データをサード パーティと共有するには、抽出を .csv ファイルに保存します。エクスポートされた CSV ファイルは、BOM 付きの UTF-8 でエンコードされます。

• Microsoft Excel (.xlsx): バージョン 2021.1.2 以降、フロー データを Microsoft Excel スプレッドシートに出力できます。レガシーの Microsoft Excel .xls のファイル タイプには対応していません。

Web 上での Tableau Prep Builder

フロー出力を、パブリッシュされたデータ ソースまたはデータベースへの出力としてパブリッシュします。

• フロー出力をデータ ソースとして Tableau Server または Tableau Cloud に保存して、データを共有し、クリーニング、加工、および結合したデータへの一元的なアクセスを提供します。
• フロー出力をデータベースに保存して、クリーニングおよび準備されたフロー データを含むテーブル データを作成、置換、または追加します。詳細については、「フロー出力データを外部データベースに保存する」を参照してください。

フローを実行するときに増分更新を使用して、フル データ セットではなく新しいデータのみを更新することによって、時間とリソースを節約します。増分更新を使用して、フローを構成して実行する方法について詳しくは、「増分更新を使用したフロー データの更新」を参照してください。

注: Tableau Prep Builder の出力を Tableau Server にパブリッシュするには、Tableau Server REST API を有効にする必要があります。詳しくは、Tableau Rest API ヘルプの「REST API の要件 (英語)(新しいウィンドウでリンクが開く)」を参照してください。セキュア ソケット レイヤー (SSL) 暗号化証明書を使用するサーバーにパブリッシュするには、Tableau Prep Builder を実行しているマシンで追加構成ステップが必要です。詳しくは、Tableau Desktop および Tableau Prep Builder 導入ガイドの「インストールの前に(新しいウィンドウでリンクが開く)」を参照してください。

フロー出力にパラメーターを含める

バージョン 2021.4 以降の Tableau Prep Builder および Web 上でサポートされています

フロー出力ファイル名、パス、テーブル名、またはカスタム SQL スクリプト (バージョン 2022.1.1 以降) にパラメーター値を含めて、さまざまなデータ セットのフローを簡単に実行できるようにします。詳細については、「フローでパラメーターを作成して使用する」を参照してください。

抽出ファイルを作成する

注: この出力オプションは、Web 上でフローを作成または編集する場合は使用できません。

1. ステップでプラス アイコン をクリックし、[出力の追加] を選択します。

   以前にフローを実行したことがある場合は、出力ステップでフローの実行 ボタンをクリックします。そうすると、フローが実行され、出力が更新されます。

   [出力] ペインが開き、データのスナップショットが表示されます。

   

2. 左側のペインで、[Save output to (出力の保存先)] ドロップダウン リストから [ファイル] を選択します。以前のバージョンで [ファイルに保存] を選択します。

3. [参照] ボタンをクリックし、[名前を付けて抽出を保存] ダイアログでファイル名を入力して [許可] をクリックします。

4. [Output type (出力タイプ)] フィールドで、次の出力タイプから選択します。

   • Tableau データ抽出 (.hyper)

   • コンマ区切り値 (.csv)

5. (Tableau Prep Builder バージョン 2020.2.1 以降) [書き込みオプション] セクションで、既定の書き込みオプションを表示して、新しいデータをファイルに書き込み、必要に応じて変更します。詳細については、書き込みオプションの構成を参照してください。

   • [テーブルの作成]: このオプションでは、新しいテーブルが作成されるか、既存のテーブルが新しい出力に置き換えられます。

   • [テーブルに追加]: このオプションでは、既存のテーブルに新しいデータが追加されます。テーブルが存在しない場合は、新しいテーブルが作成され、以降の実行でこのテーブルに新しい行が追加されます。

     注: [テーブルに追加] では、.csv の出力タイプには対応していません。対応している更新の組み合わせの詳細については、フロー更新オプションを参照してください。

6. [フローの実行] をクリックしてフローを実行し、抽出ファイルを生成します。

Microsoft Excel ワークシートへの抽出を作成する

Tableau Prep Builder バージョン 2021.1.2 以降でサポートされています。この出力オプションは、Web 上でフローを作成または編集する場合は使用できません。

フロー データを Microsoft Excel ワークシートに出力するには、新しいワークシートを作成するか、既存のワークシートにデータを追加・置換できます。以下の条件が適用されます。

• 対応しているファイル形式は Microsoft Excel .xlsx のみです。
• ワークシートの行はセル A1 から始まります。
• データを追加したり置換する場合、最初の行はヘッダーと見なされます。
• ヘッダー名は、新しいワークシートを作成するときに追加されますが、既存のワークシートにデータを追加する場合は追加されません。
• 既存のワークシートの書式や式は、フロー出力に適用されません。
• 名前付きのテーブルや範囲への書き込みは、現在対応していません。
• 増分更新は現在サポートされていません。

Microsoft Excel ワークシート ファイルにフロー データを出力する

1. ステップでプラス アイコン をクリックし、[出力の追加] を選択します。

   以前にフローを実行したことがある場合は、出力ステップでフローの実行 ボタンをクリックします。そうすると、フローが実行され、出力が更新されます。

   [出力] ペインが開き、データのスナップショットが表示されます。

   

2. 左側のペインで、[Save output to (出力の保存先)] ドロップダウン リストから [ファイル] を選択します。

3. [参照] ボタンをクリックし、[名前を付けて抽出を保存] ダイアログでファイル名を入力するか選択して、[許可] をクリックします。

4. [Output type (出力タイプ)] フィールドで [Microsoft Excel (.xlsx)] を選択します。

   

5. [ワークシート] フィールドで、結果を書き込むワークシートを選択するか、フィールドに新しい名前を入力して、[新しいテーブルの作成] をクリックします。

6. [書き込みオプション] セクションで、次のいずれかのオプションを選択します。

   • テーブルの作成: フロー データが含まれるワークシートを作成するか、ファイルが既に存在する場合は再作成します。

   • テーブルに追加: 既存のワークシートに新しい行を追加します。ワークシートが存在しない場合は、ワークシートが作成され、フローの実行時にそのワークシートに行が追加されます。

   • データの置換: 既存のワークシートの最初の行を除く既存のデータをすべてフローのデータに置き換えます。

     ワークシートが既に存在する場合、フィールドの比較には、ワークシート内のフィールドと一致するフローのフィールドが表示されます。新規のワークシートの場合は、1 対 1 のフィールド一致が表示されます。一致しないフィールドは無視されます。

     

7. [フローの実行] をクリックしてフローを実行し、Microsoft Excel 抽出ファイルを生成します。

パブリッシュされたデータ ソースを作成する

1. ステップでプラス アイコン をクリックし、[出力の追加] を選択します。

   注: Tableau Prep Builder では、以前パブリッシュされたデータ ソースが更新され、データ ソースに含まれている可能性のあるデータ モデリング (計算フィールドや番号書式など) が維持されます。データ ソースを更新できない場合は、代わりにデータ モデリングを含むデータ ソースが置き換えられます。

2. [出力] ペインが開き、データのスナップショットが表示されます。

   

3. [Save output to (出力の保存先)] ドロップダウン リストから [パブリッシュされたデータ ソース] (以前のバージョンの [データ ソースとしてパブリッシュ]) を選択します。次のフィールドを完了します。

   • サーバー(Tableau Prep Builder のみ): データ ソースとデータ抽出のパブリッシュを行うサーバーを選択します。サーバーにサインインしていない場合は、サインインするよう求められます。

     注: Tableau Prep Builder バージョン 2020.1.4 以降では、ユーザーがサーバーにサインインした後、アプリケーションを閉じるときに、Tableau Prep Builder によりサーバー名と認証資格情報が記憶されます。次回アプリケーションを開くと、既にサーバーにサインインしています。

     Mac では、Tableau Prep Builder が SSL 証明書を安全に使用して Tableau Server や Tableau Cloud 環境に接続できるよう、Mac キーチェーンへのアクセスを提供するよう求められることがあります。

     Tableau Cloud に出力している場合は、サイトがホストされているポッドを「serverUrl」に含める必要があります。たとえば、「https://online.tableau.com」ではなく「https://eu-west-1a.online.tableau.com」となります。

   • プロジェクト: データ ソースと抽出を読み込むプロジェクトを選択します。

   • 名前: ファイル名を入力します。

   • 説明: データ ソースの説明を入力します。

4. (Tableau Prep Builder バージョン 2020.2.1 以降) [書き込みオプション] セクションで、既定の書き込みオプションを表示して、新しいデータをファイルに書き込み、必要に応じて変更します。詳しくは、「書き込みオプションの構成」を参照してください。

   • [テーブルの作成]: このオプションでは、新しいテーブルが作成されるか、既存のテーブルが新しい出力に置き換えられます。

   • [テーブルに追加]: このオプションでは、既存のテーブルに新しいデータが追加されます。テーブルが存在しない場合は、新しいテーブルが作成され、以降の実行でこのテーブルに新しい行が追加されます。

5. [フローの実行] をクリックしてフローを実行し、データ ソースをパブリッシュします。

フロー出力データを外部データベースに保存する

Tableau Prep Builder ではバージョン 2020.3.1 以降、Tableau Server または Tableau Cloud では、バージョン 2020.4 以降でサポートされています。

重要: この機能を使用すると、外部データベースのデータを完全に削除したり、置き換えたりできます。データベースに書き込むためのパーミッションがあることを確認してください。
データの損失を防ぐために、[カスタム SQL] オプションを使用してテーブル データのコピーを作成し、フロー データをテーブルに書き込む前にコピーを実行できます。

Tableau Prep Builder または Web でサポートされているコネクタからデータに接続して、外部データベースにデータを出力できます。これにより、フローが実行されるたびに、フローのクリーニングされた準備済みのデータを使用して、データベース内のデータを追加または更新できます。この機能は、増分更新と完全更新の両方のオプションで使用できます。増分更新を構成する方法について詳しくは、増分更新を使用したフロー データの更新を参照してください。

フロー出力を外部データベースに保存すると、Tableau Prep は次の処理を実行します。

1. 行を生成し、データベースに対して SQL コマンドを実行します。
2. 出力データベースの一時テーブル (または Snowflake に出力する場合はステージング領域) にデータを書き込みます。
3. 操作が成功すると、データは一時テーブル (または Snowflake のステージング領域) から宛先テーブルに移動されます。
4. ユーザーがデータをデータベースに書き込んだ後に実行する必要のある SQL コマンドを実行します。

SQL スクリプトが失敗すると、フローは失敗します。ただし、データはデータベース テーブルに引き続き読み込まれます。フローの実行をもう一度やり直すか、データベースで SQL スクリプトを手動で実行して適用することができます。

出力オプション

データベースにデータを書き込むときに、次のオプションを選択できます。テーブルがまだ存在しない場合は、フローが最初に実行されるときにテーブルが作成されます。

• [テーブルに追加]: このオプションでは、既存のテーブルにデータが追加されます。テーブルが存在しない場合、フローが最初に実行されるときにテーブルが作成され、後続のフローが実行されるたびにそのテーブルにデータが追加されます。
• [テーブルの作成]: このオプションでは、フローのデータで新しいテーブルが作成されます。テーブルが既に存在する場合、テーブルと、テーブルに定義されている既存のデータ構造またはプロパティは削除され、フロー データ構造を使用する新しいテーブルに置き換えられます。フローに存在するフィールドは、新しいデータベース テーブルに追加されます。
• [データの置換]: このオプションでは、既存のテーブルのデータが削除され、フローのデータに置き換えられますが、データベース テーブルの構造とプロパティは保持されます。テーブルが存在しない場合、フローが最初に実行されるときにテーブルが作成され、後続のフローが実行されるたびにテーブル データが置き換えられます。

その他のオプション

書き込みオプションに加えて、カスタム SQL スクリプトを含めるか、データベースに新しいテーブルを追加できます。

• カスタム SQL スクリプト: カスタム SQL を入力し、データがデータベース テーブルに書き込まれる前、後、または前後にスクリプトを実行するかどうかを選択します。これらのスクリプトを使用して、フロー データがテーブルに書き込まれる前にデータベース テーブルのコピーを作成したり、インデックスを追加したり、他のテーブル プロパティを追加したりできます。

  注: バージョン 2022.1.1 以降では、SQL スクリプトにパラメーターを挿入することもできます。詳細については、「出力ステップへのユーザー パラメーターの適用」を参照してください。

• [新しいテーブルの追加]: 既存のテーブル リストからテーブルを選択するのではなく、一意の名前を持つ新しいテーブルをデータベースに追加します。既定のスキーマ (Microsoft SQL Server と PostgreSQL) 以外のスキーマを適用する場合は、構文 [schema name].[table name] を使用してスキーマを指定できます。

サポートされるデータベースとデータベース要件

Tableau Prepでは、選択した数のデータベースのテーブルへのフロー データの書き込みをサポートしています。Tableau Cloud のスケジュールに従って実行されるフローは、クラウドでホストされている場合にのみ、これらのデータベースに書き込むことができます。

Tableau Bridge を介したプライベート ネットワーク接続とオンプレミス接続はサポートされていません。Bridge を使用してデータを更新するパブリッシュされたデータ ソースを Tableau Cloud に作成すると、Prep がパブリッシュされたデータ ソースに接続できるようになります。

一部のデータベースには、データの制限や要件があります。Tableau Prep では、ピーク パフォーマンスを維持するため、サポートされているデータベースにデータを書き込む際に、いくつかの制限が設けられる場合があります。次の表に、フロー データを保存できるデータベースと、データベースの制限または要件を示します。これらの要件を満たさないデータを使用すると、フローの実行時にエラーが発生する可能性があります。

注: フィールドの文字数制限の設定はまだサポートされていません。ただし、文字制限の制約を含むテーブルをデータベースに作成し、[データの置換] オプションを使用して、データベース内のテーブル構造を維持したまま、データを置き換えることができます。

フロー データをデータベースに保存する

注: Windows 認証を使用したデータベースへのフロー出力の書き込みはサポートされていません。この認証方法を使用する場合は、ユーザー名とパスワードを使用するように接続認証を変更する必要があります。

フローをパブリッシュするときに、データベースの認証資格情報を埋め込むことができます。認証資格情報の埋め込みの詳細については、Tableau Prep Builder からフローをパブリッシュするの「データベース」セクションを参照してください。

1. ステップでプラス アイコン をクリックし、[出力の追加] を選択します。
2. [Save output to (出力の保存先)] ドロップダウン リストから [データベース テーブル] を選択します。
3. [設定]タブで、次の情報を入力します。

   • [接続] ドロップダウン リストで、フロー出力の書き込みに使用するデータベース コネクタを選択します。サポートされているコネクタのみが表示されます。これらのコネクタは、フロー入力に使用したコネクタと同じコネクタか、別のコネクタです。別のコネクタを選択すると、サインインを求めるメッセージが表示されます。

     重要: 選択したデータベースへの書き込みパーミッションがあることを確認してください。パーミッションがないと、フローでデータが部分的にしか処理されない可能性があります。

     

   • [データベース] ドロップダウン リストで、フローの出力データを保存するデータベースを選択します。

   • [テーブル] ドロップダウン リストで、フローの出力データを保存するテーブルを選択します。選択した書き込みオプションに応じて、新しいテーブルが作成されたり、フロー データによってテーブル内の既存のデータが置き換えられたり、フロー データが既存のテーブルに追加されたりします。

     データベースに新しいテーブルを作成するには、フィールドに一意のテーブル名を入力し、[新しいテーブルの作成] をクリックします。選択した書き込みオプションに関係なく、フローを初めて実行すると、フローと同じスキーマを使用してデータベースにテーブルが作成されます。

     

4. [出力] ペインには、データのスナップショットが表示されます。フィールドの比較には、テーブル内のフィールドと一致する、フローのフィールドが表示されます (テーブルが既に存在する場合)。テーブルが新規の場合は、1 対 1 のフィールド一致が表示されます。

   

   フィールドの不一致がある場合は、ステータス メモにエラーが表示されます。

   • [一致なし: フィールドは無視されます]: フィールドはフロー内に存在しますが、データベースには存在しません。[テーブルの作成] 書き込みオプションを選択して完全更新を実行しない限り、フィールドはデータベース テーブルに追加されません。完全更新を実行すると、フローのフィールドがデータベース テーブルに追加され、フロー出力スキーマが使用されます。
   • [一致なし: フィールドに Null 値が含まれます]: フィールドはデータベースに存在しますが、フローには存在しません。フローは、フィールドがあるデータベース テーブルに Null 値を渡します。フローにフィールドが存在するが、フィールド名が異なるため、フィールドが一致しない場合は、クリーニング ステップに移動し、データベースのフィールド名と一致するようにフィールド名を編集できます。フィールド名を編集する方法について詳しくは、「クリーニング操作の適用」を参照してください。
   • [エラー: フィールドのデータ型が一致しません]: フローのフィールドと、出力の書き込み先のデータベース テーブルのフィールドに割り当てられるデータ型が一致する必要があります。一致しない場合、フローの実行に失敗します。クリーニング ステップに移動し、フィールドのデータ型を編集すると、この不一致を修正できます。データ型の変更について詳しくは、「データに割り当てられたデータ型の確認」を参照してください。
5. 書き込みオプションを選択します。完全更新用と増分更新用に別のオプションを選択できます。フロー実行方法を選択するとオプションが適用されます。増分更新を使用したフローの実行について詳しくは、「増分更新を使用したフロー データの更新」を参照してください。
   • [テーブルに追加]: このオプションでは、既存のテーブルにデータが追加されます。テーブルが存在しない場合、フローが最初に実行されるときにテーブルが作成され、後続のフローが実行されるたびにそのテーブルにデータが追加されます。
   • [テーブルの作成]: このオプションでは、新しいテーブルが作成されます。同じ名前のテーブルが既に存在する場合は、既存のテーブルが削除され、新しいテーブルに置き換えられます。テーブルに定義されている既存のデータ構造やプロパティも削除され、フロー データ構造に置き換えられます。フローに存在するフィールドは、新しいデータベース テーブルに追加されます。
   • [データの置換]: このオプションでは、既存のテーブルのデータが削除され、フローのデータに置き換えられますが、データベース テーブルの構造とプロパティは保持されます。

6. (オプション) [カスタム SQL] タブをクリックし、SQL スクリプトを入力します。データがテーブルに書き込まれる [Before (前)]と [After (後)] に、実行するスクリプトを入力できます。

   

7. [フローの実行] をクリックしてフローを実行し、選択したデータベースにデータを書き込みます。

フロー出力データを CRM Analytics のデータセットに保存する

バージョン 2022.3 以降の Tableau Prep Builder および Web 上でサポートされています。

注: CRM Analytics には、外部ソースからのデータを統合する際にいくつかの要件と制限があります。フロー出力を CRM Analytics に正常に書き込めるようにするには、Salesforce ヘルプの「データをデータセットに統合する前の考慮事項」(新しいウィンドウでリンクが開く)を参照してください。

Tableau Prep を使用してデータをクリーニングし、CRM Analytics で取得する予測結果を向上させます。まず、Web で Tableau Prep Builder または Tableau Prep がサポートしているコネクタからデータに接続します。次に、変換を適用してデータをクリーニングし、フロー データをアクセス権がある CRM Analytics のデータセットに直接出力します。

CRM Analytics にデータを出力するフローは、コマンド ライン インターフェイスを使用して実行できません。Tableau Prep Builder を使用するか、Tableau Prep Conductor で Web 上のスケジュールを使用すると、フローを手動で実行することができます。

前提条件

フロー データを CRM Analytics に出力するには、Salesforce と Tableau の次のライセンス、アクセス権、パーミッションがある必要があります。

フロー出力データを Data Cloud に保存する

バージョン 2023.3 以降の Tableau Prep Builder および Web 上でサポートされています。

Tableau Prep でデータを準備してから、Data Cloud でデータと既存のデータ セットを関連付けます。Web 上で Tableau Prep Builder または Tableau Prep がサポートしているコネクタを使用して、データをインポートし、データのクリーニングと準備を行ってから、取り込み API を使用して、フロー データを Data Cloud に直接出力します。

権限の前提条件

フロー データを Data Cloud に保存する

取り込み API をすでに使用していて、この API を手動で呼び出してデータ セットを Data Cloud に保存している場合は、Tableau Prep を使用してワークフローを簡素化することができます。前提条件となる構成は、Tableau Prep の場合と同じです。

Data Cloud にデータを初めて保存する場合は、「Data Cloud の設定前提条件」の設定要件に従ってください。

1. ステップでプラス アイコン をクリックし、[出力の追加] を選択します。
2. [Save output to (出力の保存先)] ドロップダウン リストから [Salesforce Data Cloud] を選択します。



3. [オブジェクト] セクションから、サインインする [Salesforce Data Cloud 組織] を選択します。

   

4. [Salesforce Data Cloud] メニューで、[サインイン] をクリックします。

ブラウザ ウィンドウで https://login.salesforce.com/ が開きます。



5. 自分のユーザー名とパスワードを使用して、Data Cloud 組織にサインインします。
6. [アクセスを許可] フォームで、[許可] をクリックします。



7. [Save output to (出力の保存先)] セクションで、取り込み API コネクタとオブジェクト名を入力します。



データ レイク オブジェクト名は、コネクタ名とオブジェクト名の組み合わせです: IngestionAPIConnectorName-ObjectName。以下の例では、コネクタ名は TableauSchema (1) です。オブジェクト名は、typeMachineSensorDataStrin (2) です。



8. [書き込みオプション] セクションでは、指定された値がテーブルにすでに存在する場合は既存の行が更新され、指定された値が存在しない場合は新しい行が挿入されることが示されます。
9. [フローの実行] をクリックしてフローを実行し、Data Cloud にデータを書き込みます。
10. データス トリームの実行ステータスとデータ エクスプローラのオブジェクトを表示して、Data Cloud のデータを検証します。

考慮事項

• 一度に 1 つのフローを実行できます。別の出力保存を実行する前に、Data Cloud でフローの実行を完了する必要があります。
• Data Cloud にフローを保存するには、しばらく時間がかかる場合があります。Data Cloud でステータスをチェックしてください。
• データは、Upsert 関数を使用して Data Cloud に保存されます。ファイル内のレコードが既存のレコードに一致する場合、既存のレコードは、データ内の値で更新されます。一致するレコードが見つからない場合、レコードは、新しいエンティティとして作成されます。
• Prep Conductor では、同じフローを自動的に実行するようにスケジュールしている場合、データは更新されません。これは、Upsert のみがサポートされているからです。
• Data Cloud への保存プロセス中にジョブを中止することはできません。
• Data Cloud に保存される項目は検証されません。Data Cloud でデータを検証してください。

Data Cloud の設定前提条件

これらのステップは、Tableau Prep フローを Data Cloud に保存するための前提条件です。Data Cloud のコンセプトの詳細と、Tableau データ ソースと Data Cloud 間のデータ マッピングについては、「Salesforce Data Cloud について」を参照してください。

取り込み API コネクタを設定する

スキーマ ファイルを .yaml ファイル拡張子が付いた OpenAPI (OAS) 形式でアップロードして、ソース オブジェクトから取り込み API データ ストリームを作成します。スキーマ ファイルには、Web サイトのデータがどのように構造化されているかが記述されています。詳細については、YMAL ファイルの例と「取り込み API」を参照してください。

1. [設定] 歯車アイコンをクリックしてから、[Data Cloud Setup (Data Cloud の設定)] をクリックします。
2. [取り込み API] をクリックします。
3. [New (新規作成)] をクリックして、コネクタ名を入力します。
4. 新しいコネクタの詳細ページで、スキーマ ファイルを .yaml ファイル拡張子が付いた OpenAPI (OAS) 形式でアップロードします。スキーマ ファイルには、API を介して転送されるデータがどのように構造化されているかが記述されています。

注: 取り込み API スキーマには一連の要件があります。取り込む前に、「スキーマの要件」を参照してください。

5. [Preview Schema (スキーマのプレビュー)] フォームで [保存] をクリックします。

データ ストリームを作成する

データ ストリームは、Data Cloud に取り込まれるデータ ソースであり、接続と、Data Cloud に取り込まれる関連付けられたデータで構成されます。

1. アプリ ランチャーに移動し、[Data Cloud] を選択します。
2. [データ ストリーム] タブをクリックします。
3. [New (新規作成)] をクリックし、[取り込み API] を選択してから、[次へ] をクリックします。
4. 取り込み API とオブジェクトを選択します。
5. データ スペース、カテゴリ、プライマリ キーを選択してから、[次へ] をクリックします。

Data Cloud には、真のプライマリ キーを使用する必要があります。プライマリ キーが存在しない場合、プライマリ キーの数式項目を作成する必要があります。

カテゴリには、プロファイル、エンゲージメント、またはその他を選択します。エンゲージメント カテゴリ向けのオブジェクトには、日付/時刻項目が存在する必要があります。profile または other タイプのオブジェクトは、この同じ要件を強制しません。詳細については、「カテゴリ」と「プライマリキー」を参照してください。

6. [Deploy (展開)] をクリックします。

これで、データ ストリームとデータ レイク オブジェクトが用意できました。データ ストリームをデータ スペースに追加できるようになりました。

データ ストリームをデータ スペースに追加する

任意のソースからデータを Data Cloud に取り込むときは、フィルターを使用して、または使用せずに、データ レイク オブジェクト (DLO) を関連データ スペースに関連付けます。

1. [データ スペース] タブをクリックします。



2. 既定のデータ スペースか、割り当てられてたデータ スペースの名前を選択します。
3. [Add Data (データの追加)] をクリックします。
4. 作成したデータ レイク オブジェクトを選択し、[次へ] をクリックします。
5. (オプション) オブジェクトのフィルターを選択します。
6. [保存] をクリックします。

データ レイク オブジェクトを Salesforce オブジェクトにマッピングする

データ マッピングは、データ レイク オブジェクト項目をデータ モデル オブジェクト (DMO) 項目に関連付けます。

1. [データ ストリーム] タブに移動し、作成したデータ ストリームを選択します。

   

2. [データ マッピング] セクションで、[Start (開始)] をクリックします。

項目マッピングキャンバスには、ソース DLO が左側に表示され、対象 DMO が右側に表示されます。詳細については、「データモデルオブジェクトのマッピング」を参照してください。

Data Cloud 取り込み API 用の接続済みアプリを作成する

取り込み API を使用して、データを Data Cloud に送信する前に、接続済みアプリを作成する必要があります。詳細については、「API インテグレーション用の OAuth 設定の有効化」と「Data Cloud 取り込み API 用の接続済みアプリの作成」を参照してください。

取り込み API 用の接続済みアプリの設定の一環として、次の OAuth スコープを選択する必要があります。

• Data Cloud 取り込み API データにアクセスして管理する (cdp_ingest_api)
• Data Cloud のプロファイル データを管理する (cdp_profile_api)
• Data Cloud データに対して ANSI SQL クエリを実行する (cdp_query_api)
• API を介してユーザー データを管理する (api)
• ユーザーに代わっていつでも要求を実行する (refresh_token、offline_access)

スキーマの要件

Data Cloud で 取り込み API ソースを作成するには、アップロードするスキーマ ファイルが特定の要件を満たしている必要があります。「取り込み API スキーマファイルの要件」を参照してください。

• アップロードするスキーマは、.yml または .yaml ファイル拡張子が付いた有効な OpenAPI 形式である必要があります。OpenAPI バージョン 3.0.x がサポートされています。
• オブジェクトには、ネストされたオブジェクトを含めることができません。
• 各スキーマには、少なくとも 1 つのオブジェクトが必要です。各オブジェクトには、少なくとも 1 つの項目が必要です。
• オブジェクトには、1000 個を超える項目を含めることができません。
• オブジェクトは、80 文字以下にする必要があります。
• オブジェクト名には、a ～ z、A ～ Z、0 ～ 9、_、- のみが使用できます。ユニコード文字は使用できません。
• 項目名には、a ～ z、A ～ Z、0 ～ 9、_、- のみが使用できます。ユニコード文字は使用できません。
• 予約語 (date_id、location_id、dat_account_currency、dat_exchange_rate、pacing_period、pacing_end_date、row_count、version) を項目名として使用することはできません。項目名に文字列 __.を含めることはできません。
• 項目名は 80 文字以内にする必要があります。
• 項目は、次の型と形式を満たす必要があります。
  • テキスト型またはブール型の場合: 文字列
  • 数値型の場合: 数値
  • データ型の場合: 文字列、形式: 日付/時刻
• 重複したオブジェクト名 (大文字と小文字が区別される) を使用することはできません。
• オブジェクトに重複した項目名 (大文字と小文字が区別される) を含めることはできません。
• ペイロードの日付/時刻データ型項目は、yyyy-MM-dd’T’HH:mm:ss.SSS’Z' 形式の ISO 8601 UTC Zulu である必要があります。

スキーマを更新するときは、以下に注意する必要があります。

• 既存の項目データ型を変更することはできません。
• オブジェクトの更新時には、オブジェクトのすべての既存項目が存在する必要があります。
• 更新したスキーマ ファイルには変更されたオブジェクトのみが含まれるため、オブジェクトの包括的なリストを毎回提供する必要はありません。
• エンゲージメント カテゴリ向けのオブジェクトには、日付/時刻項目が存在する必要があります。profile または other タイプのオブジェクトは、この同じ要件を強制しません。

YMAL ファイルの例

openapi: 3.0.3
  components:
    schemas:
      owner:
        type: object
        required:
          - id
          - name
          - region
          - createddate 
        properties: 
          id: 
            type: integer 
            format: int64 
          name: 
            type: string 
            maxLength: 50 
          region: 
            type: string 
            maxLength: 50 
          createddate: 
            type: string 
            format: date-time 
       car: 
         type: object 
         required: 
           - car_id 
           - color 
           - createddate 
         properties: 
           car_id: 
             type: integer 
             format: int64 
         color:
           type: string 
           maxLength: 50
         createddate: 
           type: string 
           format: date-time 

このセクションの他の記事