Tableau Prep 도움말

Tableau Prep Builder에서만 지원됩니다.

Tableau Prep Builder에서 흐름을 실행하는 대신 명령줄에서 흐름을 실행하여 흐름 출력을 새로 고칠 수 있습니다. 이 방법을 사용하면 한 번에 한 흐름만 실행할 수 있습니다. 이 옵션은 Tableau Prep Builder가 설치되어 있는 Windows 및 Mac 컴퓨터에서 모두 사용할 수 있습니다.

참고: LBLM(로그인 기반 라이선스 관리)을 사용하는 경우 Tableau Prep을 정기적으로 열어야 합니다. 그렇지 않으면 임대가 만료되어 명령줄을 통해 실행되는 흐름이 실패할 수 있습니다. 관리자에게 문의하여 임대 기간을 최대 길이로 변경할 수도 있습니다. 로그인 기반 라이선스 관리(링크가 새 창에서 열림)에서 자세한 내용을 참조하십시오.

커넥터 제한 사항:

• JDBC 또는 ODBC 커넥터: 이러한 커넥터를 포함하는 흐름은 버전 2019.2.3부터 명령줄에서 실행할 수 있습니다.
• 클라우드 커넥터: Google BigQuery와 같은 클라우드 커넥터를 포함하는 흐름은 명령줄에서 실행할 수 없습니다. 대신 흐름을 수동으로 실행하거나 Tableau Prep Conductor를 사용하여 Tableau Server 또는 Tableau Cloud에서 일정에 따라 흐름을 실행해야 합니다. 자세한 내용은 흐름 데이터를 최신 상태로 유지를 참조하십시오.
• SSO(Single Sign-On) 인증: SSO 인증을 사용하는 경우 명령줄에서 흐름을 실행하는 것은 지원되지 않습니다. 대신 Tableau Prep Builder에서 흐름을 실행할 수 있습니다.
• 다단계 인증: Tableau Prep CLI(명령줄 인터페이스)는 Tableau에서 MFA(다단계 인증)를 지원하지 않습니다. 자세한 내용은 Tableau 기술 자료에서 이 문서(링크가 새 창에서 열림)를 참조하십시오.

Windows 컴퓨터의 경우 Windows 작업 스케줄러를 사용하여 이 프로세스의 일정을 설정할 수도 있습니다. 자세한 내용은 Microsoft 온라인 도움말에서 작업 스케줄러(링크가 새 창에서 열림)를 참조하십시오.

명령줄에서 흐름을 실행하면 Tableau Prep Builder가 Tableau Prep Builder에 지정된 출력 단계에 대한 설정을 사용하여 흐름에 대한 모든 출력을 새로 고칩니다. 출력 위치를 지정하는 방법에 대한 자세한 내용은 데이터 추출 파일 만들기 및 게시된 데이터 원본(링크가 새 창에서 열림)를 참조하십시오. 쓰기 옵션(버전 2020.2.1 이상) 설정에 대한 자세한 내용은 쓰기 옵션 구성을 참조하십시오.

흐름 실행 전

명령줄에서 흐름을 실행하려면 흐름을 실행하는 컴퓨터에 대한 관리자 권한이 필요하고 다음과 같은 정보가 필요합니다.

• Tableau Prep Builder가 설치되어 있는 경로

• 데이터베이스에 연결하고 출력 파일을 서버 또는 데이터베이스에 게시하는 경우(버전 2020.3.1 이상) - 모든 필수 자격 증명을 포함하는 자격 증명 .json 파일

• Tableau 흐름 파일(.tfl)이 위치한 경로

자격 증명 .json 파일 요구 사항

참고: 흐름이 로컬 파일, 네트워크 공유에 저장된 파일 또는 Windows 인증(SSPI)을 사용하는 입력 파일에 연결하고 이러한 파일에 출력하는 경우 자격 증명 .json 파일에 필요하지 않습니다. Windows 인증에 대한 자세한 내용은 Microsoft 온라인 도움말에서 SSPI Model(SSPI 모델)(링크가 새 창에서 열림)을 참조하십시오.

Tableau Prep Builder는 원격 연결이 있을 때 흐름 파일과 자격 증명 .json 파일의 정보를 사용하여 흐름을 실행합니다. 예를 들어 원격 연결의 데이터베이스 이름과 출력 파일의 프로젝트 이름은 흐름에서 가져오고 서버 이름과 로그인 자격 증명은 자격 증명 .json 파일에서 가져옵니다.

• 파일을 다시 사용할 계획이라면 Tableau Prep Builder 설치 프로세스에서 덮어쓰지 않는 폴더에 파일을 저장하십시오.
• 다음 중 하나가 포함된 흐름을 실행하는 경우 연결에 필요한 자격 증명이 포함된 .json 파일을 포함해야 합니다.
  • 데이터베이스 파일 또는 게시된 데이터 원본에 연결합니다.
  • 출력이 서버 또는 데이터베이스(버전 2020.3.1 이상)에 게시됩니다.
  • 흐름에 Rserve 또는 TabPy용 스크립트 단계가 포함됩니다. .json 파일에는 이러한 서비스에 연결하는 데 필요한 자격 증명이 포함되어야 합니다. 자세한 내용은 아래에서 사용 중인 버전의 배열 요구 사항을 참조하십시오.
• 흐름에 지정된 자격 증명과 .json 파일에 포함된 자격 증명은 일치해야 하며 그렇지 않으면 흐름이 실행되지 않습니다.
• 프로세스를 실행할 때 호스트 이름, 포트 및 사용자 이름이 Tableau 흐름 파일(.tfl)에서 일치하는 연결을 찾는 데 사용되며 프로세스를 실행하기 전에 업데이트됩니다. 포트 ID와 사이트 ID는 연결에 이 정보가 필요하지 않은 경우 선택 사항입니다.

• 게시된 데이터 원본에 연결하는 경우 hostname, contentUrl 및 port(http의 경우 80, https의 경우 443)를 입력 연결에 포함합니다. hostname은 Tableau 흐름 파일(.tfl)에서 일치하는 연결을 찾는 데 필요하고 contentUrl 및 port는 서버에 대한 연결을 설정하는 데 사용됩니다.

• Tableau Cloud에 연결하는 경우 연결하는 포드의 입력 연결에 포트(80 또는 443)를 포함합니다. 그리고 서버 연결 URl에 online.tableau.com과 함께 해당하는 포드 접두사가 포함되어 있는지 확인합니다. Tableau Cloud에 대한 자세한 내용은 Tableau Cloud 도움말에서 Tableau Cloud에 대한 Tableau Bridge 연결(링크가 새 창에서 열림)을 참조하십시오.
• (버전 2021.4.1 이상) 흐름에 매개 변수를 포함하는 경우 명령줄에서 매개 변수 재정의 .json 파일을 만들고 포함하여 매개 변수 값을 현재 기본값에서 변경할 수 있습니다. 자세한 내용은 매개 변수 값을 포함하는 흐름 실행을 참조하십시오.

Tableau Prep Builder 버전에 따라 자격 증명 정보의 형식이 다를 수 있습니다. 아래 탭을 클릭하여 Tableau Prep Builder 버전에 대한 자격 증명 형식을 확인하십시오.

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

 "\[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

/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

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

{
 "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!"
   }
 ]
}

{
 "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"
   }
 ]
}			

{
 "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"
  }
 ]
}			

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

{ 
  "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$"
    } 
  ]
}

{ 
  "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"를 사용해야 합니다.

• 입력 또는 출력 연결이 여러 개인 경우 파일에 각각의 연결에 대한 자격 증명을 포함시키십시오.

• 게시된 데이터 원본에 연결하는 경우 hostname과 contentUrl을 입력 연결에 포함해야 합니다.

흐름 실행

중요: 아래의 예에서 "Tableau Prep" 버전 2019.1.2의 이름은 "Tableau Prep Builder"로 변경되었습니다. 이전 버전의 제품을 사용하는 경우 "Tableau Prep"을 대신 사용하십시오.

1. 관리자 자격으로 명령 프롬프트 또는 터미널 명령 프롬프트(MacOS)를 엽니다.

2. 아래 표시된 구문을 사용하여 다음 명령 중 하나를 실행합니다.

   • 흐름은 로컬 파일이나 네트워크 공유에 저장된 파일에 연결하고 로컬 파일, 네트워크 공유에 저장된 파일 또는 Windows 인증을 사용하는 파일에 게시합니다.

     참고: 네트워크 공유에 저장된 파일에 연결하거나 출력하는 경우 경로에 UNC 형식을 사용하십시오(예: \\서버\경로\파일 이름). 경로가 암호로 보호되어서는 안 됩니다.

     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

   • 흐름 파일 또는 자격 증명 파일이 네트워크 공유에 저장되어 있습니다(경로에 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: 네트워크 공유를 Finder의 /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

일반적인 오류와 해결 방법에 대해서는 명령줄을 사용하여 흐름을 실행할 때 일반적인 오류를 참조하십시오.

증분 새로 고침을 사용하여 흐름 실행

Tableau Prep Builder 버전 2020.2.1 이상과 버전 2020.4부터 웹에서 지원됩니다. 흐름 출력을 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는 다음을 수행합니다.

• 증분 새로 고침을 사용하는 흐름의 모든 입력은 증분 새로 고침을 사용하여 해당하는 모든 출력을 실행합니다.
• 흐름에 증분 새로 고침을 사용하는 입력이 없는 경우 모든 출력은 전체 새로 고침을 사용하여 실행됩니다. 메시지에 새로 고침 방법의 세부 정보가 표시됩니다.
• 흐름의 일부 단계에서 증분 새로 고침을 사용하는 경우 해당하는 출력은 증분 새로 고침을 사용하여 실행됩니다. 다른 출력은 전체 새로 고침을 사용하여 실행되고 메시지에 새로 고침 방법의 세부 정보가 표시됩니다.

증분 새로 고침을 사용하도록 흐름을 구성하는 것에 대한 자세한 내용은 증분 새로 고침을 사용하여 흐름 데이터 새로 고치기를 참조하십시오.증분 새로 고침을 사용하여 흐름 데이터 새로 고치기

명령 옵션

도움말 옵션을 보려면 명령줄에 -h를 포함시키십시오.

usage: tableau-prep-cli [-c <arg>] [-d]  [-h] [-t <arg>]

-c,--connections <arg>        Path to a file with all connection information

-d,--debug                    This option is for debugging

-dsv,--disableSslValidation   Disable SSL validation

-h,--help                     Print usage message

-inc,--incrementalRefresh     Run incremental refresh for all outputs that are configured to support it

-t,--tflFile <arg>            The Tableau Prep Builder flow file	

구문 예제

아래 명령줄은 다음과 같은 기준을 사용하여 흐름을 실행하는 네 가지 서로 다른 예를 보여 줍니다.

• Tableau Prep Builder 버전: 2022.1.1

  중요: 아래의 예에서 Tableau Prep 버전 2019.1.2의 이름은 Tableau Prep Builder로 변경되었습니다. 이전 버전의 제품을 사용하는 경우 "Tableau Prep"을 대신 사용하십시오.

• 흐름 이름: Flow1.tfl

• 흐름 위치: C:\Users\jsmith\문서\내 Tableau Prep Builder 리포지토리\흐름

• 자격 증명 파일 이름: 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