--- schema_version: "1" id: fcfc9dce5f211d656e4d15a5deca23a8b8357c3a367ec4c8dd5452e135d8ced1 title: CSV 파일 가져오기 지침 collection: tableau version: next locale: ko-kr portal_url: https://docs.salesforce.com/tableau/next/ko-kr/server/csvguidelines.md canonical_url: https://help.tableau.com/v0.0/server/ko-kr/csvguidelines.htm source_site: help.tableau.com content_type: documentation content_hash: c7dfab969b78d405535a01c54cc2a4c3f262e7893bd3a939add7327f8960aa62 description: CSV file format guidelines for bulk importing users into Tableau Cloud and Tableau Cloud Manager, with required columns. --- [주요 콘텐츠로 건너뛰기](#main-content) # CSV 파일 가져오기 지침 사용자 정보가 포함된 CSV(쉼표로 구분된 값) 파일을 만들어 가져오는 방식으로 사용자를 일괄 추가할 수 있습니다. CSV 파일에 라이선스 수준 및 게시 액세스와 같은 특성을 포함하면 파일을 가져올 때 사용자에게 적용할 수 있습니다. 이 항목에서는 CSV 파일 자체에 대한 세부 정보를 다룹니다. CSV를 사용하여 사용자를 가져오려면 다음과 같이 하면 됩니다. - 서버 또는 사이트 관리 페이지를 사용합니다. 자세한 내용은 [사용자 가져오기](https://help.tableau.com/v0.0/server/ko-kr/users_import.htm)를 참조하십시오. - `tabcmd` 유틸리티를 사용합니다. 자세한 내용은 [createsiteusers filename.csv](https://help.tableau.com/v0.0/server/ko-kr/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)를 참조하십시오. 사이트 또는 서버 수준에서 사용자를 가져올 수 있습니다. 특정 사이트가 아닌 서버로 사용자를 가져오는 경우 사용자를 사이트에 할당하지 않고 라이선스 없음으로 가져옵니다. **참고:** 달리 명시되지 않는 한 이 항목에 명시된 지침은 [ID 풀](https://help.tableau.com/v0.0/server/ko-kr/identity_pools.htm) 유무와 관계없이 구성된 Tableau Server에 적용됩니다. ## CSV 파일 형식 요구 사항 사용자를 가져오기 위한 CSV 파일의 형식 요구 사항은 다음과 같습니다. - 열 머리글이 없어야 합니다. Tableau Server는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다. - BOM(바이트 순서 표시)이 있는 UTF-8 형식은 사이트로 가져올 때만 지원됩니다. Tableau Cloud Manager로 가져오는 경우 UTF-8 형식을 사용하고 파일에서 BOM을 제거해야 합니다. - BIG-5와 같은 문자 인코딩을 UTF-8로 변환해야 합니다. 이 작업은 텍스트 편집기에서 파일을 열고 다른 이름으로 저장 명령을 사용하여 수행할 수 있습니다. - 도메인 구분 기호 이외의 `@` 문자가 **username** 필드에 있는 경우 16진수 형식인 `\0x40`이어야 합니다. 예를 들어 `user@fremont@mycompany.com`은 `user\0x40fremont@mycompany.com`이 되어야 합니다. ## CSV 파일의 필수 열 구조 파일에는 머리글 행이 포함되어서는 안 됩니다. 모든 열을 채울 필요는 없지만 필요한 모든 쉼표 구분 기호를 포함하여 필수 열 구조를 유지해야 합니다. 열 구조는 제품과 가져오기 도구에 따라 다릅니다. 환경에 적합한 구조를 사용하고 있는지 확인해야 합니다. - **Tableau Cloud:** 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리자 수준, 게시 기능, 이메일 주소 - **TCM(Tableau Cloud Manager)가 있는 Tableau Cloud:** 테넌트 또는 사이트 URI, 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리자 수준, 게시 기능, 이메일 주소, 인증 유형 - **Tableau Server:** 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리 수준, 게시 기능, 이메일 주소 - **ID 풀을 사용한 Tableau Server:** 사용자 이름, 비밀번호, 표시 이름, 라이선스 수준, 관리 수준, 게시 기능, 이메일 주소, ID 풀 이름, 식별자 각 열에 사용할 수 있는 값에 대한 자세한 내용은 아래의 열 세부 정보 섹션을 참조하십시오. > [!WARNING] > > **중요:** 열의 순서는 매우 중요합니다. 열의 내용과 관계없이 첫 번째 열은 사용자 이름으로, 두 번째 열은 암호로, 세 번째 열은 표시 이름으로 처리되는 식입니다. 필드의 값을 생략해도 필드의 쉼표 구분 기호는 포함해야 합니다. ## Tableau Server의 열 세부 정보 **참고**: 특정 사이트에 로그인하지 않고 서버 수준에서 사용자를 가져오는 경우 서버 관리자 및 Unlicensed 사이트 역할만 할당할 수 있습니다. CSV 파일의 열 구조: `username, password, display name, license level, admin level, publishing capability, email address` ### 열 세부 정보  **Username:** _필수_ 항목입니다. 사용자의 이름입니다. - 서버가 Active Directory를 사용하도록 구성되어 있는 경우 이 값은 Active Directory에 정의되어 있는 사용자와 일치해야 합니다. 사용자 이름이 도메인 간에서 고유하지 않은 경우 `example\Adam`또는 `adam@example`과 같이 사용자 이름의 일부로 도메인을 포함합니다. - [ID 풀](https://help.tableau.com/v0.0/server/ko-kr/identity_pools.htm)에 사용자를 추가하는 경우 다음을 확인하십시오. - AD를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 AD sAMAccountName 값을 사용해야 합니다. - LDAP를 ID 저장소로 사용하는 ID 풀에 사용자를 추가하는 경우 사용자 이름에 LDAP username 값을 사용해야 합니다. **Password:** 사용자의 비밀번호입니다. 이 열이 필요한지 여부는 서버 구성에 따라 다릅니다. - 로컬 인증: _필수_ 항목입니다. Tableau Server 2024.2부터 비밀번호 필드가 필수 사항이 되었습니다. 자세한 내용은 기술 자료 [Tableau Server 2024.2에서 tabcmd를 통해 사용자를 추가하려고 하면 예기치 않은 'errorCode=134' 오류 발생(영문)](https://help.salesforce.com/s/articleView?id=002277940&type=1)을 참조하십시오. - Active Directory: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. **Display name:** 표시 이름은 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 이 열이 사용되는지 여부는 서버 구성에 따라 다릅니다. - 로컬 인증: 사용자의 표시 이름이 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다. - Active Directory: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. **License level:** **Creator**, **Explorer**, **Viewer** 또는 **Unlicensed**일 수 있습니다. - 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다. - 사용자 기반 서버 설치 환경에서 사용자 추가가 라이선스에서 허용하는 사용자 수를 초과하면 사용자가 라이선스 없음 사용자로 추가됩니다. - `tabcmd`를 사용하고 라이선스를 지정했지만 사용자 가져오기에서 라이선스 한도를 초과한 경우 사용자를 라이선스 없음 사용자로 가져옵니다. **Administrator level:** **System**, **Site** 또는 **None**일 수 있으며 사용자를 관리자로 가져올지 여부를 결정합니다. - System은 서버 관리자이며, Site는 사이트 관리자이고, None은 관리자가 아닌 사용자입니다. - 특정 사이트에 로그인하지 않고 서버 수준에서 사용자를 가져오는 경우 서버 관리자 및 Unlicensed 만 할당할 수 있습니다. - 웹 UI를 사용하여 사용자를 가져오는 경우 서버(모든 사이트) 수준에서 파일을 가져오는 경우에만 관리자 사이트 역할을 System으로 설정할 수 있습니다. 특정 사이트에 로그인되어 있으며 CSV 파일에 사용자의 관리자 열이 System으로 설정되어 있으면 Tableau Server가 해당 사용자를 사이트 관리자로 가져옵니다. **Publishing capability:** **Yes/True/1** 또는 **No/False/0**일 수 있습니다. 웹 UI를 사용하는 경우 특정 사이트에 로그인되어 있는 상태로 가져오는 경우에만 게시 기능이 사용됩니다. - 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다. - 라이선스 수준이 Explorer인 경우 게시 기능 값은 Explorer(게시 가능)와 Explorer 간의 사이트 역할을 구분하는 값입니다. - 라이선스 수준이 Viewer(뷰어) 또는 Unlicensed(라이선스 없음)인 경우 사용자는 이 열의 값에 관계없이 게시할 수 없습니다. **Email address**: 이메일 주소는 서버에서 사용자를 식별하는 데 사용되는 정보에 속합니다. 이메일 주소가 이미 사용되고 있는 경우 Tableau Server는 기존 사용자 정보를 CSV 파일의 설정으로 업데이트합니다. 비워 둔 열은 열 구조를 유지하기 위해 쉼표로 구분해야 합니다. ### ID 풀 ID 풀에 사용자를 추가하는 경우 표준 열과 다음 열이 필요합니다. CSV 파일의 열 구조: `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier` 추가 열 세부 정보: **Identity pool name:** 사용자를 추가할 ID 풀의 이름입니다. ID 풀에 사용자를 추가하고 ID 풀 이름을 지정하지 않으면 Tableau Server 설치 중에 TSM에서 프로비저닝한 사용자 집합인 초기 풀(TSM 구성됨)에 사용자가 추가됩니다. **Identifier:** 추가할 사용자의 식별자입니다. 식별자는 ID 일치 목적으로만 사용됩니다. 자세한 내용은 [Tableau의 사용자 이름 및 식별자](https://help.tableau.com/v0.0/server/ko-kr/identity_pools.htm#usernames_identifiers)을 참조하십시오. - 로컬 인증: _선택 사항_ - Active Directory 또는 LDAP: _필수_ #### ID 풀을 사용하여 사용자 일괄 추가 CSV 가져오기 프로세스를 사용하여 다음을 수행할 수 있습니다. - 추가 ID 풀에 사용자를 일괄 추가합니다. **참고:** CSV 가져오기 프로세스를 사용하여 사용자가 이미 속한 ID 풀을 다른 ID 풀로 바꿀 수는 없습니다. 다른 ID 풀 값을 가진 기존 사용자를 추가하면 해당 사용자가 추가 ID 풀에 추가됩니다. - 아직 식별자가 없는 사용자를 위해 식별자를 일괄 추가합니다. **참고:** 동일한 풀에 있는 사용자에 대해 다른 식별자를 추가해도 해당 사용자의 기존 식별자는 대체되지 않습니다. 대신 해당 사용자에 대한 새 식별자 레코드가 만들어집니다. ### Tableau Server의 CSV 가져오기 예제 > [!TIP] > > **팁**: 참고로, 구조는 `username, password, display name, license level, admin level, publishing capability, email address`입니다. 다음 예제에서는 여러 사용자에 대한 정보를 포함하는 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 풀 예제 > [!TIP] > > **팁**: 참고로, 구조는 `username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier`입니다. 다음 예는 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 ### 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 옵션](https://help.tableau.com/v0.0/server/ko-kr/cli_configuration-set_tsm.htm)을 참조하십시오. ## CSV 설정 및 사이트 역할 사용자에 대한 라이선스 수준, 관리자 및 게시자 설정은 가져오기 프로세스 중에 사용자의 사이트 역할이 설정되는 방식을 결정합니다. 다음은 CSV에서 사이트 역할을 캡처하는 방법을 보여줍니다.
사이트 역할License levelAdministrator levelPublishing capability

서버 관리자

이 역할은 서버를 관리하는 동안 사용자를 가져오는 경우에만 유효합니다(즉, 특정 사이트에 로그인하지 않은 경우).

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

사이트 관리자 Creator 또는 사이트 관리자 Explorer

이러한 역할은 특정 사이트에 로그인한 상태에서 사용자를 가져오는 경우에만 유효합니다.

Creator 또는 ExplorerSiteTrue
CreatorCreatorNoneTrue
Explorer(게시 가능)ExplorerNoneTrue
ExplorerExplorerNoneFalse
Viewer(뷰어)Viewer(뷰어)NoneFalse
UnlicensedUnlicensedNoneFalse