마이그레이션 계획: 통합 문서
원본 및 대상 사이트에 로그인했고 프로젝트를 선택했습니다. 다음 단계는 통합 문서의 마이그레이션을 준비하는 것입니다.
참고: 통합 문서 또는 데이터 원본에 추출이 포함된 경우 통합 문서 및 데이터 원본과 추출 마이그레이션의 정보를 읽고 이해해야 합니다.
1단계: 통합 문서 선택
원본 사이트와 선택한 프로젝트의 모든 통합 문서가 Workbook Selection 화면에 나타납니다.
이 단계 중에 원본 사이트의 통합 문서를 변경한 경우 Refresh 단추를 클릭하여 통합 문서 목록을 업데이트할 수 있습니다. 이러한 통합 문서를 선택하는 방법은 여러 가지입니다.
특정 통합 문서 선택
Specific 섹션에는 3개의 단추가 있습니다. Basic(기본) 섹션에서 선택하면 마이그레이션 계획에서 명시적으로 선택한 통합 문서가 즉시 포함됩니다. 또는 특정 통합 문서를 클릭하여 개별적으로 선택할 수 있습니다.
Select All(모두 선택)
이 단추는 사이트의 모든 통합 문서를 선택하거나 선택 취소합니다. 계획을 저장한 후 통합 문서가 사이트에 추가된 경우 다음에 계획을 사용할 때 자동으로 추가되지 않습니다.
표시:
축소판
기본 뷰는 각 통합 문서를 쉽게 구분할 수 있는 축소판 미리 보기로 표시합니다. 이 뷰에서 축소판을 마우스오버하면 통합 문서 안에 있는 다른 워크시트 및 대시보드의 미리 보기가 표시됩니다.
목록
목록 뷰는 보다 간결한 목록이며 통합 문서 이름, 프로젝트, Tableau 버전 및 마지막 수정 날짜 등의 추가 정보도 제공합니다.
열 머리글을 클릭하면 통합 문서가 그에 따라 정렬됩니다. 또한 통합 문서를 마우스오버하면 통합 문서 안에 있는 워크시트 및 대시보드의 움직이는 미리 보기가 제공됩니다. 목록 뷰는 사이트에 많은 양의 통합 문서가 있는 경우 특히 유용합니다.
규칙 기반 선택
Rule Based 선택 항목을 사용하여 특정 기준을 기반으로 통합 문서를 선택할 수 있습니다. 이러한 규칙 기반 옵션은 마이그레이션 계획을 실행할 때 사용할 통합 문서 선택 기준을 만듭니다. Rule Based 옵션 중 하나에서 "all(전체)"을 선택하는 것은 Specific Workbooks 선택 항목과 다르다는 것에 주의하십시오. 규칙 기반 "all(전체)" 선택 항목에는 항상 모든 통합 문서가 포함되므로 새로 추가된 통합 문서가 장래 마이그레이션에 포함됩니다.
Rule Based 라디오 단추를 사용하면 다음과 같은 옵션을 사용하여 통합 문서를 선택할 수 있습니다.
Workbooks in projects
이 메뉴를 사용하면 특정 프로젝트에서 통합 문서를 선택할 수 있습니다.
Workbooks tagged with
이 메뉴를 사용하면 태그를 기준으로 통합 문서를 선택할 수 있습니다.
Workbooks published by
이 메뉴를 사용하면 작성자를 기준으로 통합 문서를 선택할 수 있습니다.
각 옵션을 사용할 때 각 항목 옆에 있는 옵션을 클릭하여 개별 항목 또는 여러 항목을 선택할 수 있습니다. 선택한 모든 통합 문서는 Selection Description 상자에 표시됩니다.
모든 통합 문서 선택
마지막 옵션은 All Workbooks 라디오 단추를 선택하여 사이트의 모든 프로젝트에 있는 모든 통합 문서를 선택하는 것입니다.
All Workbooks 라디오 단추를 사용하는 것은 Specific Workbook 방법을 사용하여 모든 통합 문서를 선택하는 것과 다릅니다. 이 단추를 사용하면 이후에 마이그레이션 계획을 사용할 때마다 원본 사이트의 모든 통합 문서가 사용되기 때문입니다.
통합 문서 선택 항목이 올바른지 확인하고 Next를 클릭합니다.
2단계: 통합 문서 매핑
이제 선택한 통합 문서를 원본 파일에서 대상 파일로 매핑할 수 있습니다. 매핑을 사용하는 경우 원본 통합 문서의 표시 이름을 변경하고 다른 대상을 선택할 수 있습니다. 또한 매핑을 추가하여 통합 문서의 프로젝트, 접두사 또는 접미사를 변경할 수 있습니다. 이 섹션에서 프로젝트를 대상에 추가할 수도 있습니다.
여기서 변경을 수행하지 않으면 선택한 통합 문서가 원본과 동일한 이름으로 동일한 프로젝트에 마이그레이션됩니다. 대상 사이트에서 프로젝트를 정의하지 않은 경우 기본 프로젝트에 마이그레이션됩니다. 통합 문서 매핑을 추가하려면 Add Mapping(매핑 추가) 단추를 클릭합니다. 매핑 영역에 다음 옵션이 나타납니다.
Rename Workbook(통합 문서 이름 바꾸기)
이 변환을 사용하면 Source 프로젝트를 기준으로 필터링하고 이름을 바꿀 통합 문서를 선택할 수 있습니다. Destination 필드에서 통합 문서를 이동할 프로젝트를 선택하고 원하는 이름을 입력합니다.
프로젝트 변경
기본적으로 통합 문서는 대상의 동일한 프로젝트로 마이그레이션됩니다. 이 매핑을 사용하면 원본 프로젝트의 모든 통합 문서에 대한 대상 프로젝트를 변경할 수 있습니다.
Add Project(프로젝트 추가)
통합 문서의 이름을 바꾸거나 프로젝트를 변경할 때 Add New 옵션을 사용하면 대상 사이트에 로그인하지 않고도 대상 프로젝트를 만들고 프로젝트를 수동으로 만들 수 있습니다. Add New 대화 상자를 사용하여 프로젝트와 중첩된 프로젝트를 모두 만들 수 있습니다.
Change Prefix(접두사 변경)
이 옵션을 사용하면 하나 또는 모든 원본 프로젝트의 통합 문서에 대한 접두사를 제거하거나 바꿀 수 있습니다.
Change Suffix(접미사 변경)
접두사 매핑과 마찬가지로 하나 또는 모든 원본 프로젝트의 통합 문서에 대한 접미사를 제거하거나 바꿀 수 있습니다.
3단계: 통합 문서 변환
변환 단계를 사용하여 통합 문서를 변경하고 수정할 수 있습니다.
변환은 통합 문서를 지정된 방법으로 수정합니다. 플러그인을 통해 추가 변환을 포함할 수 있으며 응용 프로그램의 이후 버전에 추가 변환이 추가됩니다. Add Transformation(변환 추가) 드롭다운 메뉴를 클릭하여 현재 선택할 수 있는 변환을 표시합니다.
변환을 선택하면 Edit Transformation(변환 편집) 창이 표시되고 선택한 통합 문서에 맞게 사용자 지정할 수 있습니다. 모든 변환은 위에서 아래로 나열된 순서대로 완료됩니다.
서로 다른 유형의 모든 변환에 대해 두 가지 기본 단계가 있습니다. 첫 번째 단계는 변환에 대한 항목을 선택하는 것입니다. 이 예에서 변환하려는 통합 문서를 선택합니다. 선택 영역은 계획 단계의 통합 문서 선택 섹션과 유사하며 기본 선택 라디오 단추의 모든 기능, 즉 Select/Unselect All(모두 선택/모두 선택 취소), Refresh(새로 고침), Thumbnail Display(축소판 표시) 및 List Display(목록 표시)를 사용할 수 있습니다. 목록의 맨 위에서 이후 변환에 대해 모든 통합 문서를 자동으로 선택하는 옵션인 Select All을 선택할 수 있습니다. 또한 통합 문서 표시 창을 새로 고쳐 원본 사이트의 변경 또는 업데이트를 반영할 수 있습니다.
두 번째 단계는 Options(옵션) 탭을 사용하여 선택한 변환에 대한 구체적인 선택 항목을 입력하는 것입니다.
Options(옵션) 탭에서 각 통합 문서 변환에 대해 서로 다른 값을 입력할 수 있으며 편집하는 변환에 따라 탭의 이름이 달라집니다.
Action URL Replacement(작업 URL 바꾸기)
이 변환을 사용하여 통합 문서의 안에 있는 URL 작업의 일부 또는 전부를 바꿀 수 있습니다. Options(옵션) 탭에서 일치할 텍스트와 대체 값을 입력합니다.
예:
URL: www.exampledev.com
일치: dev
대체: Prod
결과: www.exampleProd.com
Set Parameter Value(매개 변수 값 설정)
새 매개 변수를 정의합니다. Options(옵션) 탭에서 매개 변수 이름, 드롭다운 메뉴의 데이터 유형 및 값을 입력합니다.
Remove Images(이미지 제거)
Options(옵션) 탭에서 파일 이름을 입력하여 선택한 통합 문서의 이미지(예: 워터마크)를 제거합니다. 이미지가 없는 경우 마이그레이션 중에 경고를 수신하는 추가 확인란이 있습니다.
Remove Tooltip Commands(도구 설명 명령 제거)
선택한 통합 문서에서 모든 도구 설명 명령을 제거합니다. 이 변환의 경우 추가로 정의할 옵션이 없습니다.
Replace Images(이미지 바꾸기)
선택한 통합 문서에 내장된 이미지를 바꿉니다. 옵션 탭에서 현재 이미지와 대체 이미지의 파일 이름을 입력합니다. 로컬 파일 경로 또는 URL을 사용하여 이미지를 바꿀 수 있습니다.
예:
파일 이름: image.png
대체 이미지 URL: https://www.exampledev.com/replacementImage.png
Zoom Control Visibility(줌 컨트롤 표시)
드롭다운 메뉴에서 표시 모드 Automatic(자동), Show on Hover(마우스오버 시 표시) 또는 Hide on the Options tab(옵션 탭에서 숨기기)를 설정합니다.
Web Page URL Replacement(웹 페이지 URL 바꾸기)
이 변환을 사용하여 대시보드의 웹 페이지 URL 일부 또는 전부를 바꿀 수 있습니다. Options(옵션) 탭에서 일치할 텍스트와 대체 값을 입력합니다.
예:
URL: www.exampledev.com
일치: dev
대체: Prod
결과: www.exampleProd.com
4단계: 데이터 원본 변환
엔터프라이즈 마이그레이션에 대한 통합 문서 계획 수립의 다음 단계는 데이터 원본 변환입니다. 이 단계는 통합 문서 변환 단계와 유사하게 작동하며 통합 문서 안에 패키지된 데이터 원본에 대한 단계입니다. 게시된 데이터 원본은 프로세스의 다른 단계에서 처리됩니다.
Add Transformation(변환 추가) 드롭다운 메뉴를 클릭하면 다음과 같은 옵션이 나타납니다.
데이터 원본 변환을 선택하면 Edit Transformation(변환 편집) 창이 표시되고 선택한 데이터 원본에 맞게 사용자 지정할 수 있습니다. 모든 변환은 위에서 아래로 나열된 순서대로 완료됩니다.
서로 다른 유형의 모든 데이터 원본 변환에 대해 두 가지 기본 단계가 있습니다. 첫 번째 단계는 원하는 데이터 원본에 대한 일치 기준을 입력하는 것입니다. 선택한 연결 유형에 따라 Match Criteria(일치 기준) 탭에 더 많은 필드가 나타납니다.
입력한 기준과 일치하는 연결을 찾으려면 Preview Source Connections(원본 연결 미리 보기)를 클릭합니다.
두 번째 단계는 Options(옵션) 탭을 사용하여 선택한 변환에 대한 구체적인 선택 항목을 입력하는 것입니다.
Options(옵션) 탭에서 각 데이터 원본 변환에 대해 서로 다른 값을 입력할 수 있습니다.
Set Calculation Formula(계산 수식 설정)
옵션 탭에서 열의 계산을 바꿀 수 있습니다.
Set Connection Info(연결 정보 설정)
새 연결 값 탭에서 새 데이터 원본에 대한 인증 방법 및 연결 세부 정보를 입력합니다. 선택한 연결 유형에 따라 더 많은 필드가 나타납니다.
CMT를 사용하여 게시된 데이터 원본 변경
버전 2022.1부터는 Tableau Server(게시된 데이터 원본) 연결 유형을 선택하여 통합 문서의 게시된 데이터 원본을 변경합니다. 이렇게 하면 예를 들어 개발 콘텐츠를 프로덕션 콘텐츠로 승격하기 위해 Tableau 환경 간에 통합 문서를 마이그레이션할 때 필요한 수동 단계를 줄일 수 있습니다.
게시된 데이터 원본을 변경하려면 드롭다운 메뉴에서 데이터 원본을 선택하고 인증에 사용할 Tableau 사용자 이름을 입력합니다. 이 사용자는 대상 사이트에 있는 사용자여야 하고 게시된 데이터 원본에 대한 연결 권한이 있어야 합니다.
파일 기반 데이터 원본의 경우 사용자가 통합 문서에 액세스하면 지정된 Tableau 사용자의 사용 권한에 따라 데이터가 표시됩니다.
다른 모든 데이터 원본의 경우 뷰 또는 통합 문서를 로드할 때 사용자가 데이터베이스 자격 증명을 입력해야 합니다.
Tableau 사용자 이름을 지정하지 않으면 연결 권한이 있는 사용자만 통합 문서의 데이터를 볼 수 있습니다.
Set Custom SQL(사용자 지정 SQL 설정)
새 사용자 지정 SQL 탭에서 Match Query Name(일치 쿼리 이름)에 수정할 사용자 지정 SQL 쿼리의 이름을 입력합니다. 쿼리 이름은 데이터 원본의 물리적 계층에 있는 사용자 지정 SQL 쿼리 이름과 일치해야 합니다. 이름이 일치하지 않으면 변환이 실패합니다. 데이터 모델링 및 물리적 계층에 대한 자세한 내용은 Tableau 데이터 모델을 참조하십시오.
쿼리 이름을 입력한 후 텍스트 필드에 원하는 사용자 지정 SQL을 입력합니다. 사용자 지정 SQL은 부적절하게 사용된 경우 통합 문서의 성능에 부정적인 영향을 줄 수 있습니다.
Remove Extract(추출 제거)
이 변환에 대한 Options(옵션) 탭은 없으며 단순히 Match Criteria 정보를 입력하면 마이그레이션 중에 추출이 제거됩니다.
또한 각 변환에서 Edit Transformation 창의 왼쪽에 있는 Comments 섹션에 메모를 입력할 수 있습니다.
저장된 자격 증명 적용
버전 2022.3에서 더 이상 사용되지 않습니다. Set Connection Info(연결 정보 설정) 데이터 원본 변환을 대신 사용하십시오.
옵션 탭에서 데이터 연결을 위한 Tableau 사용자 이름과 해당하는 저장된 자격 증명 사용자 이름을 입력합니다. Tableau 사이트의 계정 설정 페이지에서 기존 데이터 연결에 대한 저장된 자격 증명만 적용할 수 있습니다. 자세한 내용은 데이터 연결을 위한 저장된 자격 증명 관리를 참조하십시오.
5단계: 게시 옵션
통합 문서 단계의 마지막 단계는 게시 옵션을 선택하고 태그, 추출 새로 고침 일정 및 사용 권한에 대한 변환을 만드는 것입니다.
Reset Dashboard Selections(대시보드 선택 항목 재설정)
이 옵션은 대시보드의 모든 개체를 선택 취소합니다.
Overwrite Newer Workbooks(최신 통합 문서 덮어쓰기)
선택한 경우 이동한 통합 문서와 동일한 시간 또는 그 이후에 만들어진 통합 문서를 덮어쓰는 경우라도 통합 문서가 마이그레이션됩니다.
Copy Workbook Permissions(통합 문서 사용 권한 복사)
선택한 경우 마이그레이션 도구에서 최대한 일치하는 원본 통합 문서 사용 권한을 찾으려고 시도합니다.
Copy Extract Refresh Schedules(추출 새로 고침 일정 복사)
선택한 경우 마이그레이션 도구에서 대상 통합 문서 추출 새로 고침 일정을 원본 이름과 일치하는 일정으로 설정하려고 합니다.
참고: Tableau Cloud에서는 추출 새로 고침 일정을 만들 수 없습니다. 대상이 Tableau Cloud 사이트인 경우 이 옵션을 사용할 수 없습니다. 자세한 내용은 마이그레이션 제한을 참조하십시오.
Copy Embedded Credentials for Workbooks(통합 문서의 내장된 자격 증명 복사)
통합 문서에 내장된 데이터 원본의 내장된 자격 증명을 복사합니다. Tableau Server에서 Tableau Cloud 사이트로 마이그레이션할 때만 사용할 수 있습니다. 자세한 내용은 통합 문서 및 데이터 원본과 내장된 자격 증명 마이그레이션을 참조하십시오.
참고: CMT는 OAuth 연결에서 내장된 자격 증명 마이그레이션을 지원하지 않습니다. OAuth 자격 증명을 대상 사이트로 마이그레이션하려면 Set Connection Info(연결 정보 설정) 데이터 원본 변환을 사용합니다.
통합 문서 소유자 복사
원본 위치의 통합 문서 소유자 설정을 복사하여 통합 문서 소유자를 할당합니다. 선택하지 않으면 Content Migration Tool 사용자에게 대상 위치의 통합 문서 소유권이 제공됩니다.
사용자 매핑 적용
사용자 매핑을 적용하여 콘텐츠 소유권을 할당합니다. 대상 위치의 사용자 이름 구문에 차이가 있는 경우 이 옵션을 선택합니다. 자세한 내용은 마이그레이션 계획: 사용 권한 및 소유권을 참조하십시오.
Add Option(옵션 추가)
Add Option 드롭다운 메뉴를 클릭하면 추가할 수 있는 다양한 유형의 변환이 표시됩니다.
서로 다른 유형의 모든 변환에 대해 두 가지 기본 단계가 있습니다. 첫 번째 단계는 변환에 대한 항목을 선택하는 것입니다. 이 예에서 변환하려는 통합 문서를 선택합니다. 선택 영역은 계획 수립 단계의 통합 문서 선택 섹션과 유사하며 기본 선택 라디오 단추의 모든 기능, 즉 Select/Unselect All, Refresh, Thumbnail Display 및 List Display를 사용할 수 있습니다. 목록의 맨 위에서 이후 변환에 대해 모든 통합 문서를 자동으로 선택하는 옵션인 Select All을 선택할 수 있습니다. 또한 통합 문서 표시 창을 새로 고쳐 원본 사이트의 변경 또는 업데이트를 반영할 수 있습니다.
두 번째 단계는 Options(옵션) 탭을 사용하여 선택한 변환에 대한 구체적인 선택 항목을 입력하는 것입니다. 참고: 편집하는 변환에 따라 Options(옵션) 탭의 이름이 달라집니다.
Add Tags(태그 추가)
하나 이상의 태그를 통합 문서에 추가할 수 있습니다. 이전에 입력한 태그를 마우스오버하면 삭제를 허용하는 파란색 “X”가 나타납니다.
Remove Tags(태그 제거)
하나 이상의 태그를 통합 문서에 추가할 수 있습니다. 이전에 입력한 태그를 마우스오버하면 삭제를 허용하는 파란색 “X”가 나타납니다. 원본 또는 대상 통합 문서에서 태그를 제거하도록 선택할 수도 있습니다.
Apply Extract Refresh Schedules(추출 새로 고침 일정 적용)
대상 추출 새로 고침 일정을 마이그레이션된 통합 문서에 적용할 수 있습니다. 생성된 일정 목록은 대상에서 생성된 것입니다.
참고: Tableau Cloud에서는 추출 새로 고침 일정을 만들 수 없습니다. 대상이 Tableau Cloud 사이트인 경우 이 옵션을 사용할 수 없습니다. 자세한 내용은 마이그레이션 제한을 참조하십시오.
Set Permissions(사용 권한 설정)
이 변환은 선택한 통합 문서의 사용 권한을 편집합니다. Group(그룹) 또는 User(사용자)에 입력한 다음 Add를 클릭합니다. 사용 권한을 원하는 대로 조정합니다. 네 가지 옵션은 사용 권한을 허용하는 Allow , 사용 권한을 거부하는 Deny , Inherit 또는 원본 값을 유지하는 Source Value입니다.
Set Generate Thumbnail As(축소판 생성 설정)
마이그레이션 후에 통합 문서 축소판에서 사용자별 데이터를 생성할 때 사용할 사용자 또는 그룹을 설정할 수 있습니다. 각 옵션에는 원하는 사용자 또는 그룹을 선택할 수 있는 드롭다운이 있습니다.
6단계: 다음 단계로 계속
통합 문서 및 기본 설정을 선택한 후 Next 를 클릭하여 계획 수립 단계의 마이그레이션 계획: 게시된 데이터 원본 섹션으로 계속합니다.
이 작업을 수행할 수 있는 사용자
Explorer 이상의 역할이 있는 Tableau 사이트 사용자. 콘텐츠를 마이그레이션하려면 통합 문서 및 원본 사이트에 대한 보기 및 복사본 다운로드/저장 기능과 대상 사이트의 대상 프로젝트에 대한 보기 및 게시 기능이 있어야 합니다. 자세한 내용은 사용 권한을 참조하십시오.