Tableau Server Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

Treasure DataでTableau Serverを使用すると、膨大な量のデータをインタラクティブに探索し、組織全体でデータ情報を共有できます。

Tableau Serverへのエクスポートのサンプルワークフローについては、Treasure Boxesを参照してください。

前提条件

• Treasure Dataの基本知識。
• Tableau Serverのライセンスとそのインストール。
• HTTPS(SSL)を設定する必要があります。Tableau ServerでSSLを設定してください。

制限事項

• Tableauはタイムスタンプの小数秒をサポートしていません。クエリでTIMESTAMP型にキャストする前に、小数秒を削除してください(例: subtle()関数を使用)。

• 最大結果レコードは250,000,000レコードです。これを超えると、ログに次のメッセージが表示されます: Extract file records limit exceeded: 250000000.

• 最小のTimestamp値は1000-01-01 00:00:00です。これを超えると、ログに無効な日付値メッセージが表示されます。

• REST API経由でTableau Server 10.5に公開された.hyperエクストラクトは、Tableau Consoleで.tdeファイル拡張子を持ちます。これらのエクストラクトは依然として.hyperファイル形式であり、他の.hyperエクストラクトと同様に機能します。この問題は2018.1で修正されています。詳細: Tableau Server 2018.1 Release Notes (Issue ID 754677を検索)

• ネストされたProjectに属するData SourceはREST APIを使用して追加できません。Resource Not Foundエラーが返されます。Replaceモードにはこの問題はありません。修正はTableau Server 2018.1.4で予定されています。このエラーが発生した場合は、最新バージョンのTableau Serverにアップグレードすることをお勧めします。

• PATで認証する場合、そのPATを使用して一度に1つのプロセスしか実行できません(ユーザー名とパスワードで認証する場合とは異なります)。最初のジョブがまだ実行中に同じPATを使用して2番目の認証を実行すると、最初のジョブの認証/承認が削除され、エラーが発生します。 ジョブログに次のメッセージが表示されます:

  2021-12-26 07:55:47.926 +0000 [WARN] (0001:transaction): Retrying 2/7 after 2 seconds. Message: javax.ws.rs.WebApplicationException: HTTP 401 Unauthorized
  ....
  2021-12-26 07:57:53.523 +0000 [ERROR] (main): org.embulk.util.retryhelper.RetryGiveupException: java.lang.NullPointerException

既存の出力設定をTableau Hyperに移行する

TableauはHyperと呼ばれるテクノロジーでデータエンジンを更新しました。これを活用するには、既存のTreasure Data出力設定を更新する必要があります。新しいTreasure Data設定は自動的に最新バージョンを使用します。

既存の設定をアップグレードするには:

1. Queriesに移動し、スケジュールされたクエリを選択します。
2. Query Editorで、Export Resultsターゲットを選択します。
3. 保存済みのTableau接続を選択します。
4. Site IDの値を入力します。これはマルチテナントTableau Serverに必須です(デフォルトサイトにサインインする場合は空のままにします)。
5. Data Source Typeに'hyper'を選択します。
6. Doneを選択して設定を保存します。

レガシーTableauから現在のTableauに移行する場合、タイムゾーン設定を変更する必要はありません。デフォルト値(UTC)のままにすることができます。この記事のtimezoneも参照してください。

Tableau接続情報の取得

Tableauアプリ内のコマンドラインから、またはTableau管理者から、次の情報を取得します:

• Host
• Username
• Password
• Server Version

Tableauに接続するためのユーザープロファイルには、読み取りとエクスポートの権限が必要です。

site属性に使用する値を決定するには、Tableau Serverにサインインし、URLの/site/の後に表示される値を確認します。たとえば、次のURLでは、siteの値はMarketingTeamです:

https://MyServer/#/site/MarketingTeam/projects

site属性が空の文字列の場合、デフォルトサイトにサインインしています。サインイン時にサイトを指定しない場合でも、常に特定のサイトにサインインしています。

Tableau ServerのREST APIリファレンスを読んでください。

Tableau OnlineのUser/Passwordによる認証方法は廃止され、PAT(personal access token)に置き換えられました。

PATを取得するには: https://help.tableau.com/current/pro/desktop/en-us/useracct.htm#create-and-revoke-personal-access-tokens

Project

Tableau Serverには少なくとも1つの'Default'プロジェクトが必要です。このプロジェクトは削除または名前変更できません。Project Nameオプションを省略すると、'Default'プロジェクトが使用されます。

一部のまれなケース、主に英語以外のTableau Serverでは、'Default'プロジェクト名がローカライズされており、Project Nameを指定しないとジョブが失敗します(名前として'Default'を持つプロジェクトが見つからなかったため)。

TD Consoleを使用して接続を作成する

新しい接続を作成する

クエリを実行する前に、Treasure Dataでデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。

1. TD Consoleを開きます。

2. Integrations Hub > Catalogに移動します。

3. Tableauを検索して選択します。

Create Authenticationを選択します。

認証するための認証情報を入力します。

接続の名前を入力します。

Doneを選択します。

クエリを定義する

Tableauの統合パラメータ

クエリ例

次のクエリ例では、アクセスログのサンプルデータセットを使用し、1日あたりのHTTPメソッドの分布を計算します。便宜上、Datetime列をTableauで文字列からTIMESTAMPにキャストします。

HIVE:

SELECT
  CAST(TD_TIME_FORMAT(time, "yyyy-MM-dd 00:00:00") AS TIMESTAMP) AS "dates",
  method AS `Method`,
  COUNT(1) AS `Count`
FROM
  www_access
GROUP BY
  TD_TIME_FORMAT(time, "yyyy-MM-dd 00:00:00"),
  method

PRESTO:

便宜上、PrestoクエリではTD_TIME_STRINGの代わりにTD_TIME_FORMATを使用することをお勧めします。

SELECT
  CAST(TD_TIME_FORMAT(time, 'yyyy-MM-dd 00:00:00') AS TIMESTAMP) AS "dates",
  method AS `Method`,
  COUNT(1) AS `Count`
FROM
  www_access
GROUP BY
  TD_TIME_FORMAT(time, 'yyyy-MM-dd 00:00:00'),
  method

(Optional) Schedule Query Export Jobs

You can use Scheduled Jobs with Result Export to periodically write the output result to a target destination that you specify.

Treasure Data's scheduler feature supports periodic query execution to achieve high availability.

When two specifications provide conflicting schedule specifications, the specification requesting to execute more often is followed while the other schedule specification is ignored.

For example, if the cron schedule is '0 0 1 * 1', then the 'day of month' specification and 'day of week' are discordant because the former specification requires it to run every first day of each month at midnight (00:00), while the latter specification requires it to run every Monday at midnight (00:00). The latter specification is followed.

Scheduling your Job Using TD Console

1. Navigate to Data Workbench > Queries

2. Create a new query or select an existing query.

3. Next to Schedule, select None.

4. In the drop-down, select one of the following schedule options:

   Drop-down Value	Description
   Custom cron...	Review Custom cron... details.
   @daily (midnight)	Run once a day at midnight (00:00 am) in the specified time zone.
   @hourly (:00)	Run every hour at 00 minutes.
   None	No schedule.

Custom cron... Details

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)

The following named entries can be used:

• Day of Week: sun, mon, tue, wed, thu, fri, sat.
• Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.

A single space is required between each field. The values for each field can be composed of:

1. (Optional) You can delay the start time of a query by enabling the Delay execution.

Execute the Query

Save the query with a name and run, or just run the query. Upon successful completion of the query, the query result is automatically exported to the specified destination.

(Optional) You can delay the start time of a query by enabling the Delay execution.

データエクスポートの検証

1. Tableau Serverを開きます。

2. 左上のバーでData Sourcesを選択します。 TDEファイルを含むデータソースのリストを表示できます。

   

3. New Workbookを選択して、ブラウザからチャートとダッシュボードを作成します。

4. グラフを作成するには、左側のナビゲーションからディメンションとメジャーを右上のナビゲーションにドラッグアンドドロップします。

5. Saveを選択して結果を保存します。

Activate a Segment in Audience Studio

You can also send segment data to the target platform by creating an activation in the Audience Studio.

1. Navigate to Audience Studio.
2. Select a parent segment.
3. Open the target segment, right-mouse click, and then select Create Activation.
4. In the Details panel, enter an Activation name and configure the activation according to the previous section on Configuration Parameters.
5. Customize the activation output in the Output Mapping panel.

• Attribute Columns
  • Select Export All Columns to export all columns without making any changes.
  • Select + Add Columns to add specific columns for the export. The Output Column Name pre-populates with the same Source column name. You can update the Output Column Name. Continue to select + Add Columnsto add new columns for your activation output.
• String Builder
  • + Add string to create strings for export. Select from the following values:
    • String: Choose any value; use text to create a custom value.
    • Timestamp: The date and time of the export.
    • Segment Id: The segment ID number.
    • Segment Name: The segment name.
    • Audience Id: The parent segment number.

6. Set a Schedule.

• Select the values to define your schedule and optionally include email notifications.

7. Select Create.

Workflowでエクスポート結果をオプションで設定する

Treasure Workflow内で、このデータコネクタを使用してデータをエクスポートすることを指定できます。

詳細はUsing Workflows to Export Data with the TD Toolbeltを参照してください。

Tableauのワークフロー例

timezone: UTC

_export:
  td:
    database: sample_datasets
  tableau:
    datasource: datasource_name
    site_id: site_id
    project: project_name
    mode: append
    legacy: false
    datasource_type: hyper

+td-result-output-tableau:
  td>: queries/sample.sql
  result_connection: tableau_connection
  result_settings:
    datasource: ${tableau.datasource}
    site: ${tableau.site_id}
    project: ${tableau.project}
    mode: ${tableau.mode}
    legacy: ${tableau.legacy}
    target_type: ${datasource_type}