CSV 파일 가져오기 지침


사용자 정보가 포함된 CSV(쉼표로 구분된 값) 파일을 만든 후 가져오는 방식으로 사용자 추가 작업을 자동화할 수 있습니다. CSV 파일에 라이선스 수준 및 게시 액세스와 같은 특성을 포함시켜 파일을 가져올 때 사용자에게 적용할 수 있습니다.

사용자를 가져오려면 서버 또는 사이트 관리 페이지를 사용하거나 tabcmd 유틸리티를 사용할 수 있습니다. tabcmd 사용 시 CSV 파일에 포함된 모든 사용자에게 사이트 역할을 할당하는 옵션이 있습니다. 자세한 내용은 사용자 가져오기 또는 createsiteusers filename.csv 항목을 참조하십시오.

사이트 또는 서버 수준에서 사용자를 가져올 수 있습니다. 특정 사이트가 아닌 서버로 사용자를 가져오는 경우 사용자를 사이트에 할당하지 않고 라이선스 없음으로 가져옵니다.

참고: 달리 명시되지 않는 한 이 항목에 명시된 지침은 ID 풀(링크가 새 창에서 열림)이 구성되거나 구성되지 않은 Tableau Server에 적용됩니다.

CSV 파일 형식 요구 사항

사용자를 가져오기 위한 CSV 파일을 만들 때 파일이 다음과 같은 형식 요구 사항을 충족하는지 확인하십시오.

  • 파일에 열 머리글이 포함되어 있지 않아야 합니다. Tableau Server는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다.

  • 파일이 UTF-8 형식이며 BOM(바이트 순서 표시)을 포함합니다.

  • BIG-5 같은 문자 인코딩을 UTF-8로 변환했습니다. 이 작업은 텍스트 편집기에서 파일을 열고 다른 이름으로 저장 명령을 사용하여 수행할 수 있습니다.

  • 사용자 이름에 도메인 구분 기호 이외의 의미를 나타내는 @ 문자가 포함된 경우 해당 기호를 표시할 때 16진수 형식(\0x40)을 사용해야 합니다.

    예를 들어 user@fremont@mycompany.com은 user\0x40fremont@mycompany.com이 되어야 합니다.

CSV 파일의 필수 열

각 사용자에 대해 다음과 같은 필드가 필요합니다.

  • 사용자 이름. 사용자 이름입니다. 서버가 Active Directory를 사용하도록 구성되어 있는 경우 이 값은 Active Directory에 정의되어 있는 사용자와 일치해야 합니다. 사용자 이름이 도메인 간에서 고유하지 않은 경우 example\Adam또는 adam@example과 같이 사용자 이름의 일부로 도메인을 포함시켜야 합니다.

    ID 풀(링크가 새 창에서 열림)에 사용자를 추가하는 경우 다음을 확인하십시오.

    • AD를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 AD sAMAccountName 값을 사용해야 합니다.
    • LDAP를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 LDAP username 값을 사용해야 합니다.

  • 비밀번호. 사용자의 비밀번호입니다.

    • 서버가 Active Directory를 사용하도록 구성된 경우 이 값은 사용되지 않지만 비밀번호 열이 있어야 하며 열 자체는 비어 있어야 합니다.

    • 서버가 로컬 인증을 사용하는 경우 새 사용자에 대한 비밀번호를 제공해야 합니다.

    참고: Tableau Server 2024.2부터 비밀번호 필드가 필수 사항이 되었습니다. 자세한 내용은 기술 자료 Tableau Server 2024.2에서 tabcmd를 통해 사용자를 추가하려고 하면 예기치 않은 'errorCode=134' 오류 발생(영문)을 참조하십시오.

추가 파일 가져오기 옵션

CSV 파일은 앞서 나열된 필드와 더불어 다음과 같은 필드를 표시된 순서대로 포함할 수 있습니다.

  • 표시 이름. 표시 이름은 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 사용자의 표시 이름이 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다. 서버가 Active Directory를 사용하도록 구성되어 있는 경우 이 값은 사용되지 않습니다.

  • 라이선스 수준. Creator, Explorer, Viewer 또는 Unlicensed일 수 있습니다. 특정 사용자 계정에 대해 Creator를 지정하는 경우 게시 기능도 True로 설정해야 합니다.

  • 관리자 수준(System, Site 또는 None). 이 설정은 사용자를 관리자로 가져올지 여부를 결정합니다.

    웹 UI를 사용하여 사용자를 가져오는 경우 서버(모든 사이트) 수준에서 파일을 가져오는 경우에만 관리자 사이트 역할을 System으로 설정할 수 있습니다. 특정 사이트에 로그인되어 있으며 CSV 파일에 사용자의 관리자 열이 System으로 설정되어 있으면 Tableau Server가 해당 사용자를 사이트 관리자로 가져옵니다.

  • 게시 기능(yes/true/1 또는 no/false/0). 웹 UI를 사용하는 경우 특정 사이트에 로그인되어 있는 상태로 가져오는 경우에만 게시자 설정이 사용됩니다.

  • 이메일 주소. 이메일 주소는 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 이메일 주소가 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다.

ID 풀에 사용자를 추가하는 경우 위 항목에 더해 다음 값이 필요합니다.

  • ID 풀 이름. 사용자를 추가할 ID 풀의 이름입니다.

  • 식별자. 추가할 사용자의 식별자입니다. 식별자는 ID 일치 목적으로만 사용됩니다. 자세한 내용은 Tableau의 사용자 이름 및 식별자을 참조하십시오. 참고: Active Directory(또는 LDAP) ID 저장소를 사용하는 ID 풀에 사용자를 추가하는 경우 식별자가 필요합니다. 로컬 ID 저장소를 사용하는 ID 풀에 사용자를 추가하는 경우 식별자는 선택 사항입니다.

    참고:

    • ID 풀에 사용자를 추가하고 ID 풀 이름을 지정하지 않으면 Tableau Server 설치 중에 TSM에서 프로비저닝한 사용자 집합인 초기 풀(TSM 구성됨)에 사용자가 추가됩니다.

    • 사용자 이름 값에 대해 다음을 확인하십시오.

      • AD를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 AD sAMAccountName 값을 사용해야 합니다.
      • LDAP를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 LDAP username 값을 사용해야 합니다.

    • CSV 가져오기 프로세스를 사용하여 다음을 수행할 수 있습니다.

      • 추가 ID 풀에 사용자를 일괄 추가합니다. 참고: CSV 가져오기 프로세스를 사용하여 사용자가 이미 속한 ID 풀을 다른 ID 풀로 바꿀 수는 없습니다. 다른 ID 풀 값을 가진 기존 사용자를 추가하면 해당 사용자가 추가 ID 풀에 추가됩니다.

      • 아직 식별자가 없는 사용자를 위해 식별자를 일괄 추가합니다. 참고: 동일한 풀에 있는 사용자에 대해 다른 식별자를 추가해도 해당 사용자의 기존 식별자는 대체되지 않습니다. 대신 해당 사용자에 대한 새 식별자 레코드가 만들어집니다.

중요: 열의 순서는 매우 중요합니다. 열의 내용과 관계없이 첫 번째 열은 사용자 이름으로, 두 번째 열은 암호로, 세 번째 열은 표시 이름으로 처리되는 식입니다. 필드의 값을 생략해도 필드의 쉼표 구분 기호는 포함해야 합니다.

tabcmd를 통해 전달된 큰 CSV 파일의 성능 개선

참고: 이러한 설정은 Tableau Server 버전 2022.1 이하에 적용됩니다. 이러한 설정이 영향을 미치는 검색 및 인덱스 서비스는 버전 2022.3부터 사용 중단되었며 2023.3에서는 사용 중지(완전히 제거됨)되었습니다.

서버 관리자는 tabcmd 명령을 통해 큰 CSV 파일을 가져올 때 성능을 개선하는 데 도움이 되는 서버 설정을 사용하도록 설정할 수 있습니다. 이 작업은 tsm configuration set 명령과 다음과 같은 옵션을 사용하여 수행할 수 있습니다.

  • vizportal.csv_user_mgmt.index_site_users

  • vizportal.csv_user_mgmt.bulk_index_users

  • searchserver.index.bulk_query_user_groups

기본적으로 이러한 옵션은 사용자가 서버 데이터베이스에 추가될 때 한 명씩 인덱싱하는 것이 아니라 CSV 파일을 처리한 후에 사용자를 인덱싱합니다. 따라서 파일을 처리하는 데 필요한 메모리와 데이터베이스 호출 횟수가 줄어듭니다. 이러한 tsm configuration set 옵션은 tabcmd createsiteusers, deletesiteusers, addusers 및 removeusers 명령에 적용됩니다.

이러한 설정에 대한 설명은 tsm configuration set 옵션을 참조하십시오.

참고

  • 특정 사이트에 로그인하지 않고 서버 수준에서 사용자를 가져오는 경우 서버 관리자 및 라이선스 없음 사이트 역할만 할당할 수 있습니다.

  • 사용자 기반 서버 설치 환경에서 사용자 추가가 라이선스에서 허용하는 사용자 수를 초과하면 사용자가 라이선스 없음 사용자로 추가됩니다.

  • tabcmd를 사용하고 라이선스를 지정했지만 사용자 가져오기에서 라이선스 한도를 초과한 경우 사용자를 라이선스 없음으로 가져옵니다.

CSV 설정 및 사이트 역할

사용자에 대한 라이선스 수준, 관리자 및 게시자 설정은 가져오기 프로세스 중에 사용자의 사이트 역할이 설정되는 방식을 결정합니다. 다음 표에서는 이러한 설정이 사이트 역할로 변환되는 방식을 보여 줍니다.

CSV 설정사이트 역할

라이선스 수준=(any)

관리자=System

게시자=true

서버 관리자. 이 설정은 Tableau Server에만 적용되며 서버를 관리하는 상태, 즉 특정 사이트에 로그인하지 않은 상태에서 사용자를 가져오는 경우에만 유효합니다.

서버 관리자 사이트 역할은 Creator 라이선스를 사용할 수 있으면 항상 해당 라이선스를 사용합니다. 사용할 수 있는 Creator 라이선스가 없는 경우 라이선스 문제 해결에서 Tableau Server가 이 문제를 처리하는 방식에 대해 알아보십시오.

라이선스 수준=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

라이선스 없음

Tableau Server의 CSV 가져오기 예제

다음 예제에서는 여러 사용자에 대한 정보를 포함하는 CSV 파일을 보여 줍니다.

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw@example.com
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds@example.com
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw@example.com
michellek,michellepassword,Michelle Kim,Creator,System,yes,michellek@example.com

사이트를 관리하는 동안 이 파일을 가져오는 경우 해당 사이트에 사용자 네 명이 추가됩니다. 사용자 Michelle의 Administrator 설정은 System입니다. 하지만 사용자를 사이트로 가져오기 때문에 Tableau Server가 Michelle에게 사이트 관리자 Creator 사이트 역할을 부여합니다. 사용자 중 세 명에게 게시가 허용되어 있습니다.

서버를 관리하는 동안 이 파일을 가져오는 경우 서버에 사용자 네 명이 추가되지만 어떠한 사이트에도 사용자가 추가되지 않습니다. 한 사용자만 서버 관리자로 가져오고 나머지 사용자는 라이선스 없음으로 설정됩니다.

ID 풀 예제

다음 예는 ID 풀에 추가된 사용자 2명에 대한 정보를 포함하는 CSV 파일을 보여줍니다.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors,fsuzuki

다음 예는 추가 ID 풀에 추가된 사용자 2명에 대한 정보를 포함하는 CSV 파일을 보여줍니다.

henryw,henrypassword,Henry Wilson,Viewer,None,yes,hwilson@myco.com,General Contractors 2,hwilson
freds,fredpassword,Fred Suzuki,Creator,None,no,fsuzuki@myco.com,General Contractors 2,fsuzuki

다음 예는 기존 식별자가 없는 사용자 2명에 대한 정보를 포함하는 CSV 파일을 보여줍니다.

janes,janepassword,Jane Smith,Viewer,None,yes,jsmith@myco.com,General Contractors,jwang
laurar,laurapassword,Laura Rodriguez,Creator,None,no,lrodriguez@myco.com,General Contractors,jrodriguez
맨 위로 이동
피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!