--- schema_version: "1" id: d4cc7afd8fb28e78713477fb86d5bde5cff657d8440913d0907cb4fbfbcfa3f7 title: CSV 파일 가져오기 지침 collection: tableau version: current locale: ko-kr portal_url: https://docs.salesforce.com/tableau/current/ko-kr/online/csvguidelines.md canonical_url: https://help.tableau.com/current/online/ko-kr/csvguidelines.htm source_site: help.tableau.com content_type: documentation content_hash: 918887439ce13147779931d0a078df420b2239f4ed0200e93c606616b14970fe 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/current/online/ko-kr/users_import.htm)를 참조하십시오. - `tabcmd` 유틸리티를 사용합니다. 자세한 내용은 [createsiteusers filename.csv](https://help.tableau.com/current/online/ko-kr/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)를 참조하십시오. - Tableau Cloud Manager를 사용합니다. 자세한 내용은 [Tableau Cloud Manager로 사용자 관리](https://help.tableau.com/current/online/ko-kr/cloud_manager_users.htm)를 참조하십시오. ## CSV 파일 형식 요구 사항 사용자를 가져오기 위한 CSV 파일의 형식 요구 사항은 다음과 같습니다. - 열 머리글이 없어야 합니다. Tableau Cloud는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다. - 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 Cloud CSV의 열 세부 정보 CSV 파일에 사용자 이름 값(이메일 주소)만 포함된 경우 사용자가 사이트 초대 이메일을 받습니다. 사용자는 사이트에 가입하여 자신의 계정을 만들 수 있지만 관리자가 계정을 구성(표시 이름, 라이선스 수준 등)할 때까지 계정에 라이선스가 부여되지 않습니다. 사이트에서 사용자의 이메일 주소는 처음 로그인할 때까지 선행 마침표(예: `.user@domain.com`)와 함께 사이트에 표시될 수 있습니다. CSV 파일의 열 구조: _username, password, display name, license level, administrator level, publishing capability, email address_ ### 열 세부 정보 비워 둔 열은 열 구조를 유지하기 위해 쉼표로 구분해야 합니다. **Username:** _필수_ 항목입니다. 사용자의 이메일 주소입니다. **Password**: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. - 새 사용자는 Tableau Cloud에 처음 로그인할 때 비밀번호와 표시 이름을 선택해야 합니다. 사용자에게 Tableau 계정이 이미 있는 경우 비밀번호도 이미 보유하고 있을 수 있습니다. **Display name**: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. **License level:** **Creator**, **Explorer**, **Viewer** 또는 **Unlicensed**일 수 있습니다. 비워 두면 라이선스 수준이 Unlicensed(라이선스 없음)가 됩니다. **Administrator level**: **Site** 또는 **None**일 수 있습니다. 비워 두면 관리자 수준은 None(없음)이 됩니다. - Site는 사이트 관리자이고, None은 관리자 이외의 사용자입니다. - **참고**: Cloud는 Tableau Cloud Manager를 사용하는 경우에만 관련되는 값입니다. 자세한 내용은 [Tableau Cloud Manager로 사용자 관리](https://help.tableau.com/current/online/ko-kr/cloud_manager_users.htm)를 참조하십시오. **Publishing capability:** **Yes/True/1** 또는 **No/False/0**일 수 있습니다. 비워 두면 게시 기능이 false가 됩니다. - 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다. - 라이선스 수준이 Explorer인 경우 게시 기능 값은 Explorer(게시 가능)와 Explorer 간의 사이트 역할을 구분하는 값입니다. - 라이선스 수준이 Viewer(뷰어) 또는 Unlicensed(라이선스 없음)인 경우 사용자는 이 열의 값에 관계없이 게시할 수 없습니다. **Email address:** 2025년 7월(Tableau 2025.2)부터 사용자 이름과 다른 이메일 주소를 지정할 수 있습니다. 이메일 주소는 알림 목적으로만 사용됩니다. 이메일 주소 값이 제공되지 않으면 Tableau Cloud는 필수 사용자 이름 필드의 값을 사용하여 알림을 보냅니다. 보안상의 이유로 단일 사이트의 멤버인 사용자의 이메일 주소만 지정할 수 있습니다. ### TCM을 사용하지 않는 인증 유형 Tableau Cloud Manager를 사용하지 않는 경우 업로드 중에 하나의 기본 인증 유형만 설정할 수 있습니다. 나중에 개별 사용자의 인증 유형을 변경할 수 있습니다. - Tableau Cloud에서 CSV 파일을 직접 업로드하는 경우 파일을 가져올 때 인증 유형을 지정하면 가져온 모든 사용자에게 해당 유형이 적용됩니다. - `tabcmd`를 사용하여 사용자를 가져오는 경우 업로드 중에 CSV 파일에 있는 모든 사용자에게 적용되는 인증 유형 및 사이트 역할을 설정할 수도 있습니다. 자세한 내용은 [createsiteusers filename.csv](https://help.tableau.com/current/online/ko-kr/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)를 참조하십시오. 업로드 시 사용자별로 특정 인증 유형을 설정하려면 Tableau Cloud Manager를 사용해야 합니다. 자세한 내용은 [Tableau Cloud Manager로 사용자 관리](https://help.tableau.com/current/online/ko-kr/cloud_manager_users.htm)를 참조하십시오. ### Tableau Cloud CSV 구조 예 > [!TIP] > > **팁:** 참고로, 구조는 `username, password, display name, license level, administrator level, publishing capability, email address`이며, 열을 비워 두려면 쉼표 사이에 공백을 넣으면 됩니다. 다음 예제에서는 Explorer(게시 가능) 사이트 역할이 부여되고, 사이트 관리자가 아니며, 적절한 콘텐츠 사용 권한이 있는 프로젝트에 게시할 수 있는 사용자를 보여 줍니다. user1@domain.com,,,Explorer,None,true,user1@domain2.com 관리자 수준 열을 변경하면 다음 사용자를 사이트 관리자 Explorer 사이트 역할이 있는 사이트 관리자로 가져올 수 있습니다. adminuser@domain.com,,,Explorer,Site,true,adminuser@domain2.com ## TCM CSV의 열 세부 정보 CSV 파일에 사용자 이름(이메일 주소) 값만 포함된 경우 사용자가 사이트 초대 이메일을 받습니다. 사용자는 사이트에 가입하여 자신의 계정을 만들 수 있지만 관리자가 계정을 구성(표시 이름, 라이선스 수준 등)할 때까지 계정에 라이선스가 부여되지 않습니다. 참고로, 비워 둔 열은 열 구조를 유지하기 위해 쉼표로 구분해야 합니다. CSV 파일의 열 구조: `tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type` ### 열 세부 정보 **Tenant or site URI:** 테넌트 또는 사이트의 Uniform Resource Identifier입니다. **Username:** _필수_ 항목입니다. 사용자의 이메일 주소입니다. **Password**: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. - 새 사용자는 Tableau Cloud에 처음 로그인할 때 비밀번호와 표시 이름을 선택해야 합니다. 사용자에게 Tableau 계정이 이미 있는 경우 비밀번호도 이미 보유하고 있을 수 있습니다. **Display name**: _무시됩니다_. 가장 좋은 방법은 이 열을 비워 두는 것입니다. **License level:** 사이트에 대해 **Creator**, **Explorer**, **Viewer** 또는 **Unlicensed**일 수 있습니다. 비워 두면 라이선스 수준이 Unlicensed(라이선스 없음)가 됩니다. **Administrator level**: **Site**, **Cloud** 또는 **None**일 수 있습니다. 비워 두면 관리자 수준은 None(없음)이 됩니다. - Site는 사이트 관리자이고, None은 관리자가 아닌 사용자이며 Cloud는 Cloud 관리자입니다. **Publishing capability:** 사이트에 대해 **True** 또는 **False**일 수 있습니다. 비워 두면 게시 기능이 false가 됩니다. - 라이선스 수준이 Creator인 경우 게시 기능은 True여야 합니다. - 라이선스 수준이 Explorer인 경우 게시 기능 값은 Explorer(게시 가능)와 Explorer 간의 사이트 역할을 구분하는 값입니다. - 라이선스 수준이 Viewer(뷰어) 또는 Unlicensed(라이선스 없음)인 경우 사용자는 이 열의 값에 관계없이 게시할 수 없습니다. **Authentication type:** 테넌트 또는 사이트에 액세스하기 위한 사용자 인증 유형입니다. **Google**, **OpenID**, **Salesforce**, **SAML**, **TableauIDWithMFA** 또는 **DEFAULT**일 수 있습니다. ### TCM CSV 구조 예제 > [!TIP] > > **팁:** 참고로, 구조는 `tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type`이며, 열을 비워 두려면 쉼표 사이에 공백을 넣으면 됩니다. 다음 예에서는 Tableau Cloud Manager에서 Cloud 관리자 역할을 부여받고 Tableau 및 MFA를 사용하여 인증하는 사용자를 보여줍니다. TCM,cloudadminuser@domain.com,,,,Cloud,,TableauIDWithMFA 인증 열을 변경하면 Tableau Cloud Manager 설정에 대체 인증 유형이 구성된 경우 대체 인증 유형을 사용하여 다음 사용자를 가져올 수 있습니다. TCM,cloudadminuser@domain.com,,,,Cloud,,Salesforce 다음 예에서는 Explorer(게시 가능) 사이트 역할과 Tableau 및 MFA 인증을 사용하는 사용자를 가져올 수 있습니다. MySite,user1@domain.com,,,Explorer,None,True,TableauIDWithMFA ## CSV 설정 및 사이트 역할 사용자에 대한 라이선스 수준, 관리자 및 게시자 설정은 가져오기 프로세스 중에 사용자의 사이트 역할이 설정되는 방식을 결정합니다. 다음은 CSV에서 사이트 역할을 캡처하는 방법을 보여줍니다.
사이트 역할License levelAdministrator levelPublishing capability

Cloud 관리자

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

UnlicensedCloudFalse

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

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

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