CSV 파일 가져오기 지침
사용자 정보가 포함된 CSV(쉼표로 구분된 값) 파일을 만든 후 가져오는 방식으로 사용자 추가 작업을 자동화할 수 있습니다. CSV 파일에 라이선스 수준 및 게시 액세스와 같은 특성을 포함시켜 파일을 가져올 때 사용자에게 적용할 수 있습니다.
사용자를 가져오려면 사이트 관리 페이지 또는 tabcmd 유틸리티를 사용하면 됩니다. tabcmd 사용 시 CSV 파일에 포함된 모든 사용자에게 사이트 역할을 할당하는 옵션이 있습니다. 자세한 내용은 사용자 가져오기 또는 createsiteusers filename.csv 항목을 참조하십시오.
CSV 파일 형식 요구 사항
사용자를 가져오기 위한 CSV 파일을 만들 때 파일이 다음과 같은 형식 요구 사항을 충족하는지 확인하십시오.
파일에 열 머리글이 포함되어 있지 않아야 합니다. Tableau Cloud는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다.
파일이 UTF-8 형식이며 BOM(바이트 순서 표시)을 포함합니다.
BIG-5 같은 문자 인코딩을 UTF-8로 변환했습니다. 이 작업은 텍스트 편집기에서 파일을 열고 다른 이름으로 저장 명령을 사용하여 수행할 수 있습니다.
사용자 이름에 도메인 구분 기호 이외의 의미를 나타내는 @ 문자가 포함된 경우 해당 기호를 표시할 때 16진수 형식(
\0x40)을 사용해야 합니다.예를 들어
user@fremont@mycompany.com은user\0x40fremont@mycompany.com이 되어야 합니다.
CSV 파일의 필수 열
각 사용자에 대해 다음과 같은 필드가 필요합니다.
사용자 이름: 사용자의 이메일 주소입니다.
비밀번호. Tableau Cloud는 이 필드를 사용하지 않지만 후속 필드를 올바르게 배치하려면 각 행에서 이 필드를 구분 기호로 분리해야 합니다.
추가 CSV 열 옵션
각 사용자에 대해 CSV 파일에 필수 열과 더불어 다음과 같은 필드를 포함할 수 있습니다. 표시된 경우, Tableau Cloud는 필드를 사용하지 않지만 필드가 파일에 기록되어야 합니다.
사이트 URI(Tableau Cloud Manager만 해당): 사이트의 Uniform Resource Identifier입니다. 사용자를 Cloud 관리자로 가져오려면 사이트 URI 열을 포함하되 해당 열을 비워 둡니다.
표시 이름. Tableau Cloud는 이 필드를 사용하지 않지만 후속 필드를 올바르게 배치하려면 각 행에서 이 필드를 구분 기호로 분리해야 합니다.
라이선스 수준. Creator, Explorer, Viewer 또는 Unlicensed일 수 있습니다.
관리자 수준: 값은 Cloud, Site 또는 None일 수 있습니다. Cloud = Cloud 관리자, Site = 사이트 관리자, None = 관리자가 아닙니다.
참고: Cloud 관리자 값은 사용자를 Tableau Cloud Manager로 가져올 때만 사용할 수 있습니다. Tableau Cloud 사이트에서 사용하기 위한 것이 아닙니다. 자세한 내용은 Tableau Cloud Manager로 사용자 관리를 참조하십시오.
게시 기능. 허용 가능한 값은 Yes/True/1 또는 No/False/0입니다. 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다.
인증 유형(Tableau Cloud Manager만 해당): 사이트 또는 Tableau Cloud Manager에 액세스하기 위한 사용자 인증 유형입니다.
CSV 파일 샘플 항목
Tableau Cloud 사이트
다음 예제에서는 Explorer 사이트 역할이 부여되고, 사이트 관리자가 아니며, 적절한 콘텐츠 사용 권한이 있는 프로젝트에 게시할 수 있는 사용자를 보여 줍니다.
user1@domain.com,,,Explorer,None,true
관리자 수준 열을 변경하면 다음 사용자를 사이트 관리자 Explorer 사이트 역할이 있는 사이트 관리자로 가져올 수 있습니다.
adminuser@domain.com,,,Explorer,Site,trueTableau Cloud Manager
다음 예에서는 Tableau Cloud Manager에서 Cloud 관리자 역할을 부여받고 Tableau 및 MFA를 사용하여 인증하는 사용자를 보여줍니다.
,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA
인증 열을 변경하면 Tableau Cloud Manager 설정에 대체 인증 유형이 구성된 경우 대체 인증 유형을 사용하여 다음 사용자를 가져올 수 있습니다.
,cloudadminuser@domain.com,,,,Cloud,,Salesforce
참고
CSV 파일에 사용자 이름 값(이메일 주소)만 포함된 경우 사용자가 사이트 초대 이메일을 받습니다. 사용자는 사이트에 가입하여 자신의 계정을 만들 수 있지만 관리자가 계정을 구성(표시 이름, 라이선스 수준 등)할 때까지 계정에 라이선스가 부여되지 않습니다.
비밀번호(두 번째 값) 및 표시 이름(세 번째 값) 필드는 Tableau Cloud에서 사용되지 않습니다. 이들 필드에 지정한 값은 무시됩니다.
하지만 사용자의 라이선스와 게시 액세스 권한을 설정하려면 이전 예제에 나와 있는 것처럼 파일에 계속 이들 필드의 구분 기호를 포함해야 합니다.
새 사용자는 Tableau Cloud에 처음 로그인할 때 비밀번호와 표시 이름을 선택해야 합니다. 사용자에게 Tableau 커뮤니티 포럼에 사용하는 것과 같은 Tableau 계정이 있으면 암호도 이미 보유하고 있는 것입니다.
CSV 파일에는 인증 유형(Tableau, Google 또는 SAML)을 설정할 수 있는 필드가 포함되지 않습니다. 인증 유형은 파일을 가져올 때 Tableau Cloud에서 지정합니다. 이 설정은 가져온 모든 사용자에게 적용되며 나중에 개별 사용자의 인증 유형을 변경할 수 있습니다.
참고: 또한
tabcmd를 사용하여 사용자를 가져오고 CSV 파일에 포함된 모든 사용자에게 적용되는 인증 유형 및 사이트 역할을 설정할 수도 있습니다. 자세한 내용은 createsiteusers filename.csv를 참조하십시오.
CSV 설정 및 사이트 역할
사용자에 대한 라이선스 수준, 관리자 및 게시자 설정은 가져오기 프로세스 중에 사용자의 사이트 역할이 설정되는 방식을 결정합니다. 다음 표에서는 이러한 설정이 사이트 역할로 변환되는 방식을 보여 줍니다.
| CSV 설정 | 사이트 역할 |
|---|---|
라이선스 수준=Unlicensed 관리자=Cloud 게시자=false | Cloud 관리자. 이 설정은 특정 사이트에 로그인한 것이 아닌 Tableau Cloud Manager에 로그인한 상태에서 사용자를 가져오는 경우에만 유효합니다. |
라이선스 수준=Creator 또는 Explorer 관리자=Site 게시자=true | 사이트 관리자 Creator 또는 사이트 관리자 Explorer. 이 설정은 특정 사이트에 로그인한 상태에서 사용자를 가져오는 경우에만 유효합니다. |
라이선스 수준=Creator 관리자=None 게시자=true | Creator |
라이선스 수준=Explorer 관리자=None 게시자=true | Explorer(게시 가능) |
라이선스 수준=Explorer 관리자=None 게시자=false | Explorer |
라이선스 수준=Viewer 관리자=None 게시자=false | Viewer(뷰어) |
라이선스 수준=Unlicensed 관리자=None 게시자=false | 라이선스 없음 |