---
schema_version: "1"
id: 76dab493b8b176935355d44d1bd12fa562b6c068098c3acdac806119bc0f7aac
title: コマンド ラインからフロー出力ファイルを更新
collection: tableau
version: next
locale: ja-jp
portal_url: https://docs.salesforce.com/tableau/next/ja-jp/prep/prep_run_commandline.md
canonical_url: https://help.tableau.com/v0.0/prep/ja-jp/prep_run_commandline.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 3e5801e0244fc48a24060f24723e1dda32765527582574adfd06fec39b6ba765
description: Refresh flow output files from the command line in Tableau Prep Builder.
---
[メイン コンテンツに進む](#main-content)

# コマンド ラインからフロー出力ファイルを更新

_Tableau Prep Builder でのみサポートされます。_

Tableau Prep Builder からフローを実行する代わりに、コマンド ラインからフローを実行してフロー出力を更新できます。この方法を使用して、一度に 1 つのフローを実行できます。このオプションは、Tableau Prep Builder がインストール済みの Windows または Mac の両マシンで利用できます。

Tableau Prep でサポートされているすべてのコマンド ライン オプションのリストについては、[「Tableau Prep Command Line Reference」](https://help.tableau.com/current/prep/en-us/prep_command_line_reference.htm)を参照してください。

**注**: ログインベースのライセンス管理 (LBLM) を使用している場合は、Tableau Prep を定期的に開いて、アクティブ化に使用した Tableau Server 環境または Tableau Cloud サイトにサインインするようにしてください。そうしなければ、リースが期限切れになるため、コマンド ラインを介して実行されるフローが失敗する可能性があります。管理者に連絡して、リース期間を最長に変更することもできます。詳細については、[「ログインベースのライセンス管理」](https://help.tableau.com/current/server/ja-jp/license_lblm.htm)を参照してください。

**コネクタの制限:**

- **JDBC または ODBC コネクタ**: これらのコネクタを含むフローは、バージョン 2019.2.3 以降のコマンド ラインから実行できます。
- **クラウド コネクタ**: Google BigQuery などのクラウド コネクタを含むフローは、コマンド ラインからは実行できません。代わりに、手動でフローを実行するか、Tableau Prep Conductor を使用して Tableau Server や Tableau Cloud のスケジュールに基づいてフローを実行します。詳細については、[フロー データを最新に維持する](https://help.tableau.com/v0.0/prep/ja-jp/prep_conductor_overview.htm)を参照してください。
- **シングル サインオン認証**: シングル サインオン認証を使用する場合、コマンド ラインからのフローの実行はサポートされていません。代わりに、Tableau Prep Builder からフローを実行できます。
- **多要素認証**: Tableau Prep のコマンド ライン インターフェイス (CLI) は、Tableau の多要素認証 (MFA) をサポートしません。詳細については、Tableau ナレッジ ベースの[「Tableau Cloud で MFA を有効にした後、コマンド ラインを使用して Tableau Prep フローをパブリッシュできない」](https://help.salesforce.com/s/articleView?id=001534203&type=1)を参照してください。

Windows マシンでは、Windows タスク スケジューラを使用して、このプロセスのスケジュールを設定できます。Microsoft オンライン ヘルプの[「Task Scheduler」](https://docs.microsoft.com/ja-jp/windows/desktop/taskschd/task-scheduler-start-page)を参照してください。

コマンド ラインからフローを実行する際、Tableau Prep Builder により、Tableau Prep Builder で指定した出力ステップの設定を使用したフローのすべての出力が更新されます。出力場所の指定方法に関する詳細は、[データ抽出ファイルとパブリッシュされたデータ ソースを作成する](https://help.tableau.com/v0.0/prep/ja-jp/prep_save_share.htm#Extract)を参照してください。書き込みオプション (バージョン 2020.2.1 以降) の設定の詳細については、[書き込みオプションの構成](https://help.tableau.com/v0.0/prep/ja-jp/prep_incremental_refresh.htm#flow-writeoptions)を参照してください。

## フローを実行する前に

コマンド ラインからフローを実行するには、フローを実行しているマシンの管理者権限と、次の情報が必要です。

- Tableau Prep Builder のインストール パス。
- データベースに接続し、出力ファイルをサーバーまたはデータベースにパブリッシュしている場合は (バージョン 2020.3.1 以降)、必要なすべての認証資格情報を含む .json 認証資格情報ファイル。
- Tableau Flow (.tfl) ファイルが置かれているパス。

### 認証資格情報 .json ファイルの要件

**注:** フローが接続して出力する先が、ローカル ファイルや、ネットワーク共有上に保管されているファイル、Windows 認証 (SSPI) を使用する入力ファイルなどの場合は、認証資格情報の .json ファイルは不要です。Windows 認証の詳細については、Microsoft オンライン ヘルプの[「SSPI Model (SSPI モデル)」](https://docs.microsoft.com/ja-jp/windows/desktop/SecAuthN/sspi-model) (英語) を参照してください。

Tableau Prep Builder は、フロー ファイルと認証資格情報の .json ファイルからの情報を使用して、リモート接続がある場合にフローを実行します。たとえば、リモート接続のデータベース名と、出力ファイル用のプロジェクト名はフローからの情報で、サーバー名とサインイン用の認証資格情報は、認証資格情報の .json ファイルからの情報です。

- ファイルを再利用する予定がある場合、Tableau Prep Builder のインストール プロセスによって上書きされないフォルダーにファイルを配置してください。
- 次のいずれかを含むフローを実行している場合は、接続に必要な認証資格情報が入った .json ファイルを含める必要があります。
    - データベース ファイルまたはパブリッシュされたデータ ソースに接続する。
    - サーバーまたはデータベース (バージョン 2020.3.1 以降) に出力をパブリッシュする。
    - Rserve または TabPy のスクリプト ステップをフローに含む。json ファイルには、これらのサービスに接続するために必要な認証資格情報が含まれている必要があります。詳細については、以下のバージョンの配列要件を参照してください。
- フローで指定された認証資格情報と .json ファイルに含まれる認証資格情報が一致する必要があります。一致しない場合は、フローの実行に失敗します。
- プロセスを実行すると、ホスト名、ポート、ユーザー名が使用され、一致する接続が Tableau フロー ファイル (.tfl) で検索され、プロセスの実行前に更新されます。接続に必要でない場合は、ポート ID とサイト ID は任意です。
- パブリッシュされたデータ ソースに接続する場合は、ホスト名、contentUrl、ポート (http の場合は 80、https の場合は 443) を入力接続に含めます。ホスト名は Tableau フロー ファイル (.tfl) 内で一致する接続を検索する際に必要となります。contentUrl とポートは、サーバーへの接続を確立するために使用します。
- Tableau Cloud に接続する場合は、接続先のポッドの入力接続にポート (80 または 443) を含め、サーバー接続 URl には対応するポッド プレフィックスと online.tableau.com を必ず含めてください。Tableau Cloud の詳細については、Tableau Cloud ヘルプの[「Tableau Cloud への Tableau Bridge 接続」](https://help.tableau.com/current/online/ja-jp/to_keep_data_fresh.htm#tableau-bridge-connections-to-tableau-online)を参照してください。
- (バージョン 2021.4.1 以降) フローにパラメーターを含める場合は、パラメーター オーバーライド .json ファイルを作成してコマンド ラインに含め、パラメーター値を現在の既定値から変更できます。詳細については、[パラメーター値を含むフローの実行](#flow_parameters)を参照してください。

Tableau Prep Builder のバージョンによっては、認証資格情報の書式設定が異なる場合があります。以下のタブをクリックして、お使いの Tableau Prep Builder バージョンの認証資格情報の書式設定を確認してください。

接続に応じて、サーバーまたはデータベースの認証資格情報、またはその両方を含めます。フローが同じサーバーまたはデータベースに接続して出力される場合は、.json ファイルに 1 つのブロックを含めるだけで済みます。異なる認証資格情報を使用するサーバーまたはデータベースに接続する場合は、コンマ区切りの配列を使用します。

<table class="simple-table">
                            <colgroup><col style="width: 264px;">
                            <col>
                            <col>
                            </colgroup><tbody>
                                <tr>
                                    <th>サーバー接続</th>
                                    <th>データベース接続</th>
                                    <th>R server 接続 または Tableau Python 接続</th>
                                </tr>
                                <tr>
                                    <td>
                                        <p>接続ブロック名: "tableauServerConnections"</p>
                                        <p>配列に次のデータを含めます。</p>
                                        <ul>
                                            <li>serverUrl (サーバー名) Tableau Cloud の場合、対応するポッド プレフィックスと online.tableau.com を含めます。例: "https://10az.online.tableau.com"</li>
                                            <li>contentUrl (サイト ID。これは Tableau Server または Tableau Cloud の URL の /site/ の後ろに表示されます。たとえば、"https://my.server/#/site/mysite" に接続するには、<code>"contentUrl": "mysite"</code> を設定します。))</li>
                                            <li>port (ポート ID)</li>
                                            <li>username</li>
                                            <li>password</li>
                                        </ul>
                                    </td>
                                    <td>
                                        <p>接続ブロック名: "databaseConnections"</p>
                                        <p>配列に次のデータを含めます。</p>
                                        <ul>
                                            <li>hostname (サーバー名)</li>
                                            <li>port (ポート ID)</li>
                                            <li>username</li>
                                            <li>password</li>
                                        </ul>
                                    </td>
                                    <td>
                                        <p>フローに R または TabPy のスクリプト ステップが含まれている場合にのみ、この配列を含めます。</p>
                                        <p>接続ブロック名: "extensions"</p>
                                        <p>配列に次のデータを含めます。</p>
                                        <ul>
                                            <li>extensionName: <code>"rSupport"</code> または <code>"pythonSupport"</code>を指定します。</li>
                                            <li>regular: "host" と "port" を含めます。必要に応じて、"username" または "sslCertificate" (base64 文字列としてエンコードされたパブリック .pem ファイルのコンテンツ) を含めることができます。</li>
                                            <li>sensitive: 使用する場合は "password" を含めます。それ以外の場合は、空の配列を含めます。</li>
                                        </ul>
                                    </td>
                                </tr>
                            </tbody>
                        </table>

**注意**: ContentUrl.は、.json ファイルのサーバー接続で必ず必要になります。既定のサイト (たとえば "https://my.server/#/site/") に接続する場合は、ContentUrl を空白に設定します。例: `"contentUrl": ""`

### パラメーター値を含むフローの実行

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

パラメーター値を含むフローをコマンド ラインから実行する場合、使用するパラメーター値を含むパラメーター オーバーライド .json ファイルを作成できます。これらの値は、パラメーターに定義されている現在の (既定) 値をオーバーライドします。

これは、credentials.json ファイルとは別のファイルであり、パラメーター名と値が含まれています。

**注**: バージョン 2022.1.1 以降は、パラメーター値を引用符で囲む必要がなくなりました。以前のバージョンでは、すべてのパラメーター名と値に引用符を含める必要がありました。

**例**:

{
    "Parameter 1": Value 1,
    "Number Parameter": 40,
    "Boolean Parameter": True
}				

フローを実行するときは、コマンド ラインに -p --parameters とファイルの名前を含めます。

**例:**

**Windows**

```
 "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json
```

**Mac**

```
/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json
```

### 例

このセクションでは、認証資格情報の .json 要件を使用して作成できる認証資格情報ファイルの例をいくつか示します。

#### サーバー接続への接続

次の例は、同じ認証資格情報を使用するサーバー接続に接続して出力する .json 認証資格情報ファイルを示しています。

{
 "tableauServerConnections":\[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
 \]
}				

#### サーバー接続への接続とデータベース接続への出力

次の例は、サーバー接続に接続してデータベース接続に出力する .json 認証資格情報ファイルを示しています。

{
 "tableauServerConnections":\[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
\],
 "databaseConnections":\[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port":"5439",
    "username":"jsmith",
    "password":"p@s$w0rd!"
   }
 \]
}

#### フローに Rserve と TabPy のスクリプト接続を含め、データベース接続へ出力する

次の例は、Rserve と Tabpy の認証資格情報を含み、データベース接続に出力する .json 認証資格情報ファイルを示しています。

{
 "extensions": \[
    {
	  "extensionName": "rSupport",
	  "regular": {
		"host": "localhost",
		"port": "9000",
		"username": "jsmith"
	},
	"sensitive": {	
	  "password": "pwd"	
	}
   },
   {
	"extensionName": "pythonSupport",
	"regular": {
	  "host": "localhost",
	  "port": "9000"
	},
	"sensitive": {
	}
   }
 \],										
 "databaseConnections":\[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port": "5439",
    "username": "jsmith",
    "password": "p@s$w0rd!"
   },
   {
    "hostname":"mysql.mydb.tsi.lan",
    "port": "3306",
    "username": "jsmith",
    "password": "mspa$$w0rd"
   }
 \]
}			

#### 異なるデータベース接続への接続と出力

次の例は、異なるデータベース接続に接続して出力する .json 認証資格情報ファイルを示しています。

{
 "databaseConnections":\[
{
  "hostname":"example123.redshift.amazonaws.com",
  "port": "5439",
  "username": "jsmith",
  "password": "p@s$w0rd!"
 },
 {
   "hostname":"mysql.mydb.tsi.lan",
   "port": "3306",
   "username": "jsmith",
   "password": "mspa$$w0rd"
  }
 \]
}			

入力接続と出力接続の配列を入力します。

**注**: Tableau Prep Builder バージョン 2018.2.2 から 2018.3.1 までを使用している場合は、入力または出力でリモート接続しない場合でも、"inputConnections" 配列と "outputConnections" 配列を常に含めるようにします。これらの配列を空白のままにします。Tableau Prep Builder バージョン 2018.3.2 以降を使用している場合、空白の配列を含める必要はありません。

<table class="simple-table">
                            <colgroup><col style="width: 260px;">
                            <col>
                            <col>
                            </colgroup><tbody>
                                <tr>
                                    <th>入力接続</th>
                                    <th>出力接続</th>
                                    <th>R server 接続 または Tableau Python 接続</th>
                                </tr>
                                <tr>
                                    <td>
                                        <ul>
                                            <li>hostname (サーバー名)</li>
                                            <li>contentUrl (パブリッシュされたデータ ソースでは必ず必要です。詳細は、<span class="uicontrol">「出力接続」</span>を参照してください。</li>
                                            <li>port (ポート ID)</li>
                                            <li>username</li>
                                            <li>password</li>
                                        </ul>
                                    </td>
                                    <td>
                                        <ul>
                                            <li>serverUrl</li>
                                            <li>contentUrl (サイト ID。これは Tableau Server または Tableau Cloud の URL の /site/ の後ろに表示されます。たとえば "https://my.server/#/site/mysite" に接続するには <code>"contentUrl": "mysite"</code>を設定します。)</li>
                                            <li>username</li>
                                            <li>password</li>
                                        </ul>
                                    </td>
                                    <td>
                                        <p>この配列は、フローの R または TabPy のスクリプト ステップがパスワードを必要とする場合にのみ含めます。</p>
                                        <ul>
                                            <li>extensionName: <code>"rSupport"</code> または <code>"pythonSupport"</code>を指定します。</li>
                                            <li>credentials: "password" を含めます。</li>
                                        </ul>
                                    </td>
                                </tr>
                            </tbody>
                        </table>

### 例

このセクションでは、認証資格情報の .json 要件を使用して作成できる認証資格情報ファイルの 2 つの異なる例を示します。

#### パブリッシュされたデータ ソースへの接続

この例では、パブリッシュされたデータ ソースに接続し、サイト ID を含むサーバーにデータを出力する .json 認証資格情報ファイルを示します。

**注**: inputConnection や outputConnection で既定のサイト (たとえば "https://my.server/#/site/") が使用されている場合は、ContentUrl を空白に設定します。例: `"contentUrl": ""`

{ 
  "inputConnections":\[
    {
     "hostname":"https://my.server",
     "contentUrl": "mysite",
     "port":443,								
     "username": "jsmith",
     "password": "passw0rd$"
    }
 \],
  "outputConnections":\[
    {
     "serverUrl":"https://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    }
 \]
}

#### 2 つのデータベースへの接続

このサンプル フローでは、MySQL と Oracle に接続して、サイト ID を含むサーバーにデータを出力する .json 認証資格情報ファイルを示します。

{ 
  "inputConnections":\[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  },
    {
     "hostname":"Oracle.example.lan",
     "port":5678,
     "username": "jsmith",				
     "password": "passw0rd" 
  }
\], 
  "outputConnections":\[
    {
     "serverUrl":"http://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    } 
  \]
}

#### フローに Rserve と TabPy のスクリプト ステップを含み、データベースに接続する

次の例は、Rserve サービスと TabPy サービスのパスワードを含み、MySQL に接続する .json 認証情報ファイルを示しています。

{ 
  "inputConnections":\[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  }
\], 
  "extensions":\[
    {
     "extensionName":"rSupport",
     "credentials":{
     "password":"pwd",
    }
  },
   {
	"extensionName" : "pythonSupport",
	"credentials": {
	"password": "pwd"
	}
   } 
  \]
}

### 認証資格情報ファイルの作成に関するヒント

フロー実行時のエラーを防ぐには、認証資格情報ファイルが次のガイドラインを満たしている必要があります。

- Tableau Prep Builder バージョン 2018.2.2 から 2018.3.1 までを使用している場合は、入力または出力でリモート接続しない場合でも、"inputConnections" 配列と "outputConnections" 配列を常に含めるようにします。これらの配列を空白のままにします。
    
    Tableau Prep Builder バージョン 2018.3.2 以降を使用している場合、空白の配列を含める必要はありません。
    
    - リモートの入力接続がない場合は、.json ファイルの冒頭に次の構文を含めます。
        
        {
         "inputConnections":\[
          \],
    - リモートの出力接続がない場合は、.json ファイルの末尾に次の構文を含めます。
    
    "outputConnections":\[
      \]
    }
- 入力接続用のポート ID がないか、またはサーバー名の一部としてポートが指定されていませんか?
    
    接続用のポート ID がない場合は、.json ファイルの `"port":xxxx,` 参照を含めないようにします。これは、`"port": ""` の場合も同じです。ポート ID がサーバー名に含まれている場合は、ホスト名にポート ID を含めます。例: `"hostname": "mssql.example.lan,1234"`
- `"serverUrl":` を参照するときに、アドレスの最後に "/" を含めないようにします。たとえば、`"serverUrl": "http://server"` のようにします。`"serverUrl": "http://server/"` とはしません。
- 入力用または出力用の接続が複数ある場合は、接続ごとの認証資格情報をファイルに含めるようにします。
- パブリッシュされたデータ ソースに接続する場合は、入力接続に必ずホスト名と contentUrl を含めてください。

## フローの実行

> [!IMPORTANT]
> 
> **重要**: 以下の例には、"Tableau Prep" バージョン 2019.1.2 から "Tableau Prep Builder" への名称の変更が含まれます。本製品の以前のバージョンを使用している場合、代わりに "Tableau Prep" を使用してください。

1. 管理者としてコマンド プロンプトやターミナル コマンド プロンプト (MacOS) を開きます。
2. 以下に示す構文を使用して、次のいずれかのコマンドを実行します。
    
    - ローカル ファイルまたはネットワーク共有上に保管されているファイルに接続し、ローカル ファイルやネットワーク共有上に保管されているファイルにパブリッシュするか、Windows 認証を使用するフローはでは次のように実行します。
        
        **注**: ネットワーク共有上に保管されているファイルに接続するかこのファイルに出力する場合、パスに UNC 形式を使用します: \\\\server\\path\\file name。パスワード保護は利用できません。
        
        **Windows**
        
        ```
         "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl"
        ```
        
        **Mac**
        
        ```
        /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl
        ```
    - データベースに接続するかサーバーにパブリッシュするフローでは次のように実行します。
        
        **Windows**
        
        ```
        "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"
        ```
        
        **Mac**
        
        ```
        /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl
        ```
    - フロー ファイルまたは認証資格情報ファイルがネットワーク共有上に保管されている (パス: \\\\server\\path\\file name に UNC 形式を使用) 場合は次のように実行します。
        
        **Windows**
        
        ```
        "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "\server\path\[your credential file name].json" -t "\server\path\[your flow file name].tfl"
        ```
        
        **Mac:** 検索でネットワーク共有を /Volumes にマップし永続的にしてから、`/Volumes/.../[your file]` を使用してパスを次のように指定します。
        
        ```
        /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c /Volumes/.../[your credential file name].json -t path/to/[your flow file name].tfl
        ```

よくあるエラーと解決策については、[コマンド ラインを使用してフローを実行する際の一般的なエラー](https://help.tableau.com/v0.0/prep/ja-jp/prep_troubleshoot.htm#cli_common_errors)を参照してください。

## 増分更新を有効にしてフローを実行

_Tableau Prep Builder バージョン 2020.2.1 以降、およびバージョン 2020.4 以降の Web でサポートされています。フロー出力を Microsoft Excel に書き込む場合、増分更新は現在サポートされていません。_

サーバーで Tableau Prep Conductor を有効にせずにフローの実行をスケジュールしている場合は、コマンド ラインから増分更新を使用してフローを実行できます。次の例に示すように、`--incrementalRefresh` パラメーターをコマンド ラインに含めます。

**Windows**

```
 "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"
```

**Mac**

```
/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl
```

フローのインプット ステップで増分更新が有効になっていて、増分更新パラメーターが適切に構成されている場合、Tableau Prep Builder は次の処理を行います。

- 増分更新が有効になっているフロー内のすべての入力では、増分更新を使用して、対応するすべての出力が実行されます。
- フロー内の入力で増分更新が有効になっていない場合、すべての出力は、完全更新を使用して実行されます。メッセージによって更新方法の詳細が示されます。
- フロー内の一部の入力で増分更新が有効になっている場合、対応する出力は、増分更新を使用して実行されます。他の出力は、完全更新を使用して実行され、メッセージにより更新方法の詳細が示されます。

増分更新を使用するためにフローを構成する方法の詳細については、[増分更新を使用したフロー データの更新](https://help.tableau.com/v0.0/prep/ja-jp/prep_incremental_refresh.htm)を参照してください。[増分更新を使用したフロー データの更新](https://help.tableau.com/v0.0/prep/ja-jp/prep_incremental_refresh.htm)

## コマンドオプション

オプションのヘルプを見たい場合はコマンドラインで `-h` を含めます。

<table class="simple-table">
                    <tbody>
                        <tr>
                            <th style="text-align: left;">コマンドオプション</th>
                            <th style="text-align: left;">説明</th>
                            <th style="text-align: left;">注</th>
                        </tr>
                        <tr>
                            <td><code>-c</code> , <code>--connections &lt;arg&gt;</code></td>
                            <td>ログイン情報ファイルへの接続パスです。</td>
                            <td>認証資格情報ファイルが置かれている場所へのパスが必要です。</td>
                        </tr>
                        <tr>
                            <td><code>-d</code>, <code>--debug</code></td>
                            <td>フロープロセスのデバッグを行います。</td>
                            <td>このオプションを含めることで、フローの更新時に発生する問題のデバッグに役立つ詳細情報が表示されます。ログ ファイルは次の場所に保管されます。<code>My Tableau Prep Builder Repository\Command Line Repository\Logs</code></td>
                        </tr>
                        <tr>
                            <td><code>-dsv</code>,<code> --disableSslValidation</code></td>
                            <td>SSL 検証を無効にします</td>
                            <td>証明書の検証を実行せずにフローを実行します。このオプションを MacOS で実行すると、キーチェーンのユーザーとパスワードを要求するダイアログが表示されることがあります。Tableau Prep Builder バージョン 2019.3.2 以降では、次のような追加パラメーターを渡してこのキーチェーン ダイアログを無効にすることができます。例: /<code>Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl</code></td>
                        </tr>
                        <tr>
                            <td><code>-h</code>, <code>--help</code></td>
                            <td>構文オプションのヘルプを表示します。</td>
                            <td>
                                <p>ヘルプ オプションあるいは構文エラーには次のような情報が表示されます。</p><pre xml:space="preserve">usage: tableau-prep-cli [-c &lt;arg&gt;] [-d]  [-h] [-t &lt;arg&gt;]</pre><pre xml:space="preserve">-c,--connections &lt;arg&gt;        Path to a file with all connection information</pre><pre xml:space="preserve">-d,--debug                    This option is for debugging</pre><pre xml:space="preserve">-dsv,--disableSslValidation   Disable SSL validation</pre><pre xml:space="preserve">-h,--help                     Print usage message</pre><pre xml:space="preserve">-inc,--incrementalRefresh     Run incremental refresh for all outputs that are configured to support it</pre><pre xml:space="preserve">-t,--tflFile &lt;arg&gt;            The Tableau Prep Builder flow file	</pre>
                            </td>
                        </tr>
                        <tr>
                            <td><code>-inc</code>, <code>--incrementalRefresh</code></td>
                            <td>増分更新を使用するように構成したすべての出力で増分更新を実行します。</td>
                            <td>
                                <p>増分更新を使用するように構成したすべての入力で増分更新を実行するには、このオプションを含めます。増分更新を使用すると、Tableau Prep Builder は、フロー内のすべての行ではなく、新しい行のみを取得して処理できます。</p>
                                <p>インプット ステップでの増分更新の構成設定によって、徐々に実行できるフロー出力が決まります。他のすべての出力は、完全更新を使用して実行され、メッセージにより更新方法の詳細が示されます。</p>
                                <p>増分更新を使用したフローの実行の詳細については、<a href="https://help.tableau.com/v0.0/prep/ja-jp/prep_incremental_refresh.htm" class="xref">増分更新を使用したフロー データの更新</a>を参照してください。</p>
                            </td>
                        </tr>
                        <tr>
                            <td><code>-t</code>, <code>--tflFile &lt;arg&gt;</code></td>
                            <td>.tfl フローファイルです</td>
                            <td>.tfl フロー ファイルが置かれている場所へのパスが必要です。</td>
                        </tr>
                        <tr>
                            <td><code>-p</code>, <code>--parameters	</code></td>
                            <td>パラメーター オーバーライド .json ファイル</td>
                            <td>フローに適用される現在の (既定) パラメーター値をオーバーライドする場合は、このファイルを含めます。フロー パラメーターを使用する方法の詳細については、<a href="https://help.tableau.com/v0.0/prep/ja-jp/prep_parameters.htm" class="xref">フローでパラメーターを作成して使用する</a>を参照してください。</td>
                        </tr>
                    </tbody>
                </table>

## 構文例

以下のコマンド ラインは、下記の条件でフローを実行する場合の 4 種類の例を示したものです。

- **Tableau Prep Builder バージョン**: 2022.1.1
    
    > [!IMPORTANT]
    > 
    > **重要**: 以下の例には、Tableau Prep バージョン 2019.1.2 から Tableau Prep Builder への名称の変更が含まれます。本製品の以前のバージョンを使用している場合、代わりに "Tableau Prep" を使用してください。
- **フロー名**: Flow1.tfl
- **フローの格納場所**: C:\\Users\\jsmith\\Documents\\My Tableau Prep Builder Repository\\Flows
- **資格認証情報ファイル名**: Flow 1.json
- **資格認証情報ファイルの格納場所**: C:\\Users\\jsmith\\Desktop\\Flow credentials
- **ネットワーク共有上の資格認証情報ファイルの格納場所**: \\tsi.lan\\files\\Flow credentials

#### フローの接続先とパブリッシュ先がローカル ファイルの場合

**Windows**

```
"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"
```

**Mac**

```
/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl
```

#### フローの接続先とパブリッシュ先がローカル ファイルであり、増分更新に短い形式を使用する場合

**Windows**

```
"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -inc -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"
```

**Mac**

```
/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -inc -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl
```

#### フローの接続先がデータベースでパブリッシュ先がサーバーの場合

**Windows**

```
"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\C:\Users\jsmith\Desktop\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"
```

**Mac**

```
/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Users/jsmith/Desktop/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl
```

#### フローのパブリッシュ先がサーバーで認証資格情報ファイルがネットワーク共有上に保管されている場合

**Windows**

```
"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\\tsi.lan\files\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"
```

**Mac**

```
/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Volumes/files/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl
```