Tableau Prep Builder 문제 해결
이 문서에는 Tableau Prep Builder 사용 시 발생할 수 있는 문제와 해당 문제를 해결하는 방법에 대한 제안 사항이 나와 있습니다.
LogShark 실행
LogShark는 Prep 로그 파일의 정보를 추출하여 문제를 해결하고 오류 및 사용량에 대한 인사이트를 얻는 데 사용할 수 있는 무료 오픈 소스 명령줄 유틸리티입니다. LogShark Prep.twbx 플러그인을 사용하여 Prep 문제를 분석하고 시각화하는 데 도움이 되는 오류 및 흐름 대시보드가 포함된 통합 문서를 생성할 수 있습니다.
LogShark를 사용하려면 처리하는 Prep 로그 파일을 압축해야 합니다. Prep 로그 파일을 찾으려면 내 Tableau Prep 리포지토리 폴더로 이동합니다. 위치는 /Users/<username>/Documents/My Tableau Prep Repository입니다.
LogShark 설치 및 실행에 대한 자세한 내용은 LogShark용으로 컴퓨터 설정을 참조하십시오.
명령줄을 사용하여 흐름을 실행할 때 일반적인 오류
Tableau Prep Builder를 열고 각 흐름을 수동으로 실행하는 대신 명령줄에서 흐름을 실행하여 프로그래밍 방식으로 출력 파일을 새로 고칠 수 있습니다. 이 프로세스는 흐름 프로세스의 효율성을 높이는 데 도움이 되지만 구문이 올바르지 않거나 연결 또는 출력 위치에 대한 자격 증명이 누락된 경우 이 프로세스를 실행할 때 오류가 발생합니다.
다음 표에는 일반적인 오류와 그에 대한 해결 방법이 설명되어 있습니다. 명령줄에서 흐름을 실행하는 방법에 대한 자세한 내용은 명령줄에서 흐름 출력 파일 새로 고침(링크가 새 창에서 열림)을 참조하십시오.
| 오류 | 원인 | 해결하는 방법 |
|---|---|---|
| "Missing arguments(인수 누락)" | 필수 명령줄 인수 중 하나가 누락되었습니다. | “tableau-prep-cli -help”를 사용하여 명령줄의 인수 목록을 확인합니다. |
| "Unable to read the connections file.(연결 파일을 읽을 수 없습니다.)" | 입력 연결에 대한 credentials.json 파일에 구문 또는 형식 오류가 있습니다. | .json 파일에서 입력 연결의 구문을 확인하십시오. 자세한 내용과 예제는 명령줄에서 흐름 출력 파일 새로 고침(링크가 새 창에서 열림)을 참조하십시오. |
"There are errors in the flow. Unable to run the flow. Check that the credentials .json file includes all required credentials. Open the flow in Tableau Prep Builder to view error details.(흐름에 오류가 있으므로 흐름을 실행할 수 없습니다. 자격 증명 .json 파일에 필요한 모든 자격 증명이 포함되어 있는지 확인하십시오. 오류 세부 정보를 보려면 Tableau Prep에서 흐름을 여십시오.)" | 입력 연결에 대한 credentials.json 파일에 자격 증명이 누락되었거나 흐름에 오류가 있습니다. | .json 파일에 모든 연결에 대한 자격 증명이 있는지 확인하고 Tableau Prep Builder에서 흐름 파일을 열어 흐름에 오류가 있는지 확인합니다. 흐름에 오류가 있으면 이를 수정하고 흐름을 Tableau Server에 다시 게시한 다음 프로세스를 다시 실행해 보십시오. |
| "Could not find match for <hostname of inputConnections >(<inputConnections의 호스트 이름>에 대한 일치 항목을 찾을 수 없음)" | credentials.json 파일에 호스트 이름(서버 이름)에 대한 항목이 누락되었습니다. | credentials.json 파일에 호스트 이름(서버 이름)에 대한 올바른 자격 증명이 포함되어 있는지 확인하십시오. 자세한 내용과 예제는 명령줄에서 흐름 출력 파일 새로 고침(링크가 새 창에서 열림)을 참조하십시오. |
| "We don't have credentials of all connections in tfl/tflx file. The following connection(s) were not found: <hostname of inputConnections>(tfl/tflx 파일에 모든 연결의 자격 증명이 없습니다. 다음 연결을 찾을 수 없습니다.<inputConnections의 호스트 이름>)" | credentials.json 파일이 누락되었거나 오류 메시지에 표시된 호스트 이름(서버 이름)에 대한 잘못된 자격 증명이 있습니다. | credentials.json 파일에 오류 메시지에 나와 있는 호스트 이름(서버 이름)에 대한 올바른 자격 증명이 포함되어 있는지 확인하십시오. 자세한 내용과 예제는 명령줄에서 흐름 출력 파일 새로 고침을 참조하십시오. |
| "Error signing in server <serverUrl> as a user <userName>. Please check the credentials.(<serverUrl> 서버에 <userName> 사용자로 로그인하는 동안 오류가 발생했습니다. 자격 증명을 확인하십시오.)" | credentials.json 파일에 Tableau Server에 대한 잘못된 자격 증명이 있습니다. | credentials.json 파일에 출력 연결에 대한 모든 올바른 자격 증명 및 요소가 포함되어 있는지 확인하십시오. 자세한 내용과 예제는 명령줄에서 흐름 출력 파일 새로 고침을 참조하십시오. |
| "Could not sign in successfully as <userName> to server <serverUrl>(<contentUrl>)(<serverUrl> 서버(<contentUrl>)에 <userName>(으)로 로그인할 수 없음)" | credentials.json 파일에 Tableau Server에 대한 잘못된 자격 증명이 있습니다. | credentials.json 파일에 출력 연결에 대한 모든 올바른 자격 증명 및 요소가 포함되어 있는지 확인하십시오. 자세한 내용과 예제는 명령줄에서 흐름 출력 파일 새로 고침을 참조하십시오. |
| "We don't have credentials for Tableau Server to publish extract for one or more output nodes in tfl/tflx file.(Tableau Server가 tfl/tflx 파일에 있는 하나 이상의 출력 노드에 대한 추출을 게시할 수 있는 자격 증명이 없습니다.)" | credentials.json 파일이 명령줄 인수로 전달되지 않았거나 출력 연결에 대한 자격 증명이 누락되었습니다. | credentials.json 파일에 대한 경로가 명령줄에 포함되어 있는지 확인하고 credentials.json 파일에 출력 연결에 대한 모든 올바른 자격 증명 및 요소가 포함되어 있는지 확인하십시오. 자세한 내용과 예제는 명령줄에서 흐름 출력 파일 새로 고침을 참조하십시오. |
| "Loom rest api server not started(Loom rest api 서버가 시작되지 않음)" | 설치 또는 환경 설정이 잘못되었습니다. | Tableau Prep Builder가 올바르게 설치되어 있으며 명령을 관리자로 실행하는지 확인하십시오. Tableau Prep Builder를 설치하는 방법에 대한 자세한 내용은 사용자 인터페이스에서 Tableau Desktop 또는 Tableau Prep Builder 설치(링크가 새 창에서 열림)를 참조하십시오. |
| "Error. Flow file does not exist.(오류. 흐름 파일이 없습니다.)" | 흐름 파일 경로가 잘못되었습니다. | 흐름 파일에 대한 올바른 경로가 명령줄에 포함되어 있는지 확인하십시오. |
| "Error. Connections file does not exist.(오류. 연결 파일이 없습니다.)" | credentials.json 파일 경로가 잘못되었습니다. | credentials.json 파일에 대한 올바른 경로가 명령줄에 포함되어 있는지 확인하십시오. |
| "Could not find match for <mapr01:5181>,<mapr02:5181>,<mapr03:5181>(<mapr01:5181>,<mapr02:5181>,<mapr03:5181>에 대한 일치 항목을 찾을 수 없습니다.)" | ZooKeeper를 사용하여 Apache Drill에 연결할 때 특정 포트 ID를 지정해야 합니다. | 입력 자격 증명에 대해 "port": 31010을 지정하는 credentials.json 파일을 명령줄에 포함합니다. |
"These features were found that prevent this version of the application from using this file" 오류
버전 2018.2.1 이상에서 만들어진 흐름을 이전 버전의 Tableau Prep Builder에서 열면 다음 오류가 표시될 수 있습니다.
이전 릴리스에서 지원되지 않는 기능을 포함하는 흐름으로 인해 이 비호환성 오류가 발생합니다. 오류를 해결하려면 최신 버전에서 흐름을 열고 지정된 기능이 없는 상태로 흐름 복사본을 저장합니다. 위 예제에서는 Null 필터가 적용되는 필드에서 해당 필터를 제거합니다.
그런 다음 이전 버전의 Tableau Prep Builder에서 기능이 제거된 복사본을 엽니다.
Tableau Prep을 사용하여 SSL 지원 Tableau Server에 로그인할 때 "You are using Server version: null..." 오류
Tableau Prep Builder에서 SSL 지원 Tableau Server에 로그인하는 경우 Tableau Prep Builder가 설치된 컴퓨터에 루트 인증서가 설치되어 있어야 합니다. 인증서가 설치되어 있지 않으면 다음 오류가 나타날 수 있습니다.
사용 중인 서버 버전은 null이지만 호환되는 최소 버전은 10.0입니다. 호환되는 버전으로 업그레이드하십시오.
이 오류가 나타나면 IT 부서 또는 시스템 관리자의 도움을 받아 Tableau Prep Builder가 설치된 컴퓨터에 필요한 루트 인증서를 설치하십시오. 자세한 내용은 Tableau Desktop 및 Tableau Prep Builder 배포 가이드에서 시스템 요구 사항(링크가 새 창에서 열림)을 참조하십시오.