마이그레이션 평가 검사: 긴 OneDrive URL

마이그레이션 동안 긴 OneDrive URL 관련 문제를 해결하는 방법을 알아봅니다.

개요

OneDrive 사이트를 원본에서 대상 환경으로 이동하는 경우 OneDrive URL의 형식이 변경됩니다. 원본 플랫폼에서 OneDrive 사이트는 형식입니다 https://onedrive.contoso.com/personal/domain_user. 대상 플랫폼에서 URL의 Domain_User 부분이 변경되어 사용자에 대해 UPN을 사용합니다. 이는 과 유사합니다 https://onedrive.contoso.com/personal/user_contoso_com.

예제:

다음 파일을 사용하는 경우:

https://OneDrive.contoto.com/personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

파일의 디렉터리 이름이 다음과 같이 표시됩니다.

Personal/contoso_bobsmith/Documents/Folder1/Folder2

참고

SharePoint에서 파일의 디렉터리 경로는 400자로 제한됩니다.

마이그레이션 후에는 파일 경로가 다음과 같이 표시됩니다.

Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

이제 URL이 이전보다 4자 더 길어지는 것을 확인합니다. 회사에서 UPN을 구성하는 방법에 따라 길이가 더 많이 변경될 수 있습니다.

원본 환경의 이전 파일이 255자이면 마이그레이션 후 길이는 259자입니다.

긴 URL로 인해 오류가 발생할 가능성이 있는 네 가지 위치를 확인했습니다. 결과적으로 긴 URL과 관련된 네 가지 보고서가 있습니다. 검사 결과 보고서 섹션에서는 수행되어야 하는 수정 작업과 함께 각 보고서에 대해 설명합니다.

데이터 마이그레이션

원본 콘텐츠의 마이그레이션으로 인해 긴 URL이 실패합니다. 이로 인해 마이그레이션 작업이 실패하여 마이그레이션 프로젝트가 불필요하게 연장됩니다.

중요

SharePoint에서 "액세스 권한 없음"(잠금)으로 구성된 사이트는 모두 건너뜁니다. 잠긴 사이트 모음 목록을 보려면 잠긴 사이트 검사 결과를 확인하세요.

마이그레이션 준비

보고서를 검토하고 각 보고서에 대해 권장되는 수정 작업을 수행합니다. 일반적으로 수정 작업에서는 사이트 모음의 루트에 더 가깝게 콘텐츠를 이동합니다.

마이그레이션 후

콘텐츠가 마이그레이션되었는지 확인합니다.

검사 결과 보고서

이 검사를 수행하면 4개의 출력 파일이 생성됩니다. 각 파일은 마이그레이션 오류가 발생하는 긴 URL 문제에 대한 것입니다. LongODBUrl-AllDocs-detail.csv 지정된 파일에 대한 경로의 길이와 관련된 두 가지 제한이 있습니다.

• 파일이 포함된 폴더의 서버 상대 경로는 최대 400자입니다. 다음 예제 파일을 사용합니다.

  https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

  디렉터리 이름은 Personal/contoso_bobsmith/Documents/Folder1/Folder2입니다.

  마이그레이션 후에는 파일 경로가 다음과 같이 표시됩니다. URL이 이전보다 4자 더 길어졌습니다.Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

• 파일 또는 폴더의 서버 상대 경로는 최대 400자입니다. 다음 예제 파일을 사용합니다.

  https://OneDrive.contoto.com/Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

  파일의 서버 상대 경로는 Personal/contoso_bobsmith/Documents/Folder1/Folder2/ProjectA.docx

이 보고서에 나열된 파일이 있는 경우 소유자는 파일을 더 짧은 경로로 이동하거나 파일을 삭제해야 합니다. 예를 들어 ProjectA.docx 문서 바로 아래의 폴더로 이동하거나 더 이상 필요하지 않은 경우 파일을 삭제할 수 있습니다.

열	설명
SiteId	영향을 받는 사이트 모음의 고유 식별자입니다.
SiteURL	영향을 받는 사이트 모음으로 이동하는 URL입니다.
SiteOwner	사이트 모음의 소유자입니다.
SiteAdmins	사이트 모음 관리자로 나열된 사용자의 목록입니다.
SiteSizeInMB	메가바이트[MB] 단위의 사이트 모음 크기입니다.
NumOfWebs	사이트 모음에 있는 웹 수입니다.
ContentDBName	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 이름입니다.
ContentDBServerName	데이터베이스 콘텐츠를 호스트하는 SQL Server입니다.
ContentDBSizeInMB	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 크기입니다.
LastContentModifiedDate	사이트 모음의 콘텐츠가 수정된 날짜/시간입니다.
TotalItemCount	사이트 모음에 있는 항목의 총 수입니다.
Hits	사이트 모음에 대해 기록된 요청 수입니다. 사용 현황 로깅 서비스의 데이터를 사용합니다. 사용 현황 로깅 서비스를 사용하지 않도록 설정한 경우 이 행은 N/A를 표시합니다.
DistinctUsers	사이트 모음에 액세스한 고유 사용자 수입니다. 사용 현황 로깅 서비스의 데이터를 사용합니다. 사용 현황 로깅 서비스를 사용하지 않도록 설정한 경우 이 행은 N/A를 표시합니다.
DaysOfUsageData	사용 현황 로깅 서비스에서 데이터를 보존하는 기간(일)입니다. Hits 및 DistinctUsers에 대한 컨텍스트를 제공합니다. 예를 들어 이 값이 14일인 경우 Hits 및 DistinctUsers 데이터는 지난 14일간의 데이터입니다.
UPN	URL 길이의 차이를 확인하는 데 사용된 UPN입니다. UPN이 "****"인 경우 소유자가 SharePoint 프로필에 UserPrincipalName을 설정하지 않았음을 나타냅니다. 따라서 SharePoint 프로필 저장소에 있는 UserPrincipalName 값의 평균 길이가 사용되었습니다.
URLLengthDifference	사이트 이름을 바꿀 때 URL이 증가하는 양입니다.
파일	수정해야 하는 파일입니다.
ScanID	SharePoint 마이그레이션 평가 도구의 특정 실행에 할당된 고유 식별자입니다.

LongODBUrl-NavNodes-detail.csv 탐색 노드의 URL 길이 제한은 260자입니다. 따라서 URL 필드가 최대 길이를 초과할 수 있습니다.

예를 들어 OneDrive 사이트가 있습니다 https://OneDrive.contoso.com/personal/contoso_bobsmith. 해당 사이트에는 보고서라는 빠른 실행의 링크와 링크의 URL이 있습니다 https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/...folderN/Reports. 마이그레이션하는 동안 SharePoint는 을 가리키도록 URL을 업데이트합니다 /bobsmith_contoso_com/. URL에 추가된 추가 길이로 인해 길이가 260자를 초과하여 마이그레이션이 실패할 수 있습니다.

이 문제를 해결하려면 /documents/ 라이브러리의 루트에 가깝게 보고서 폴더를 이동한 다음 빠른 실행 링크를 업데이트합니다. 또 다른 옵션으로 빠른 실행 링크를 제거할 수 있습니다.

열	설명
SiteId	영향을 받는 사이트 모음의 고유 식별자입니다.
SiteURL	영향을 받는 사이트 모음으로 이동하는 URL입니다.
SiteOwner	사이트 모음의 소유자입니다.
SiteAdmins	사이트 모음 관리자로 나열된 사용자의 목록입니다.
SiteSizeInMB	메가바이트[MB] 단위의 사이트 모음 크기입니다.
NumOfWebs	사이트 모음에 있는 웹 수입니다.
ContentDBName	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 이름입니다.
ContentDBServerName	데이터베이스 콘텐츠를 호스트하는 SQL Server입니다.
ContentDBSizeInMB	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 크기입니다.
UPN	URL 길이의 차이를 확인하는 데 사용된 UPN입니다. UPN이 "****"인 경우 소유자가 SharePoint 프로필에 UserPrincipalName을 설정하지 않았음을 나타냅니다. 따라서 SharePoint 프로필 저장소에 있는 UserPrincipalName의 평균 길이가 사용되었습니다.
URLLengthDifference	URLLengthDifference 사이트 이름이 바뀔 때 URL이 증가합니다.
WebURL	탐색 노드가 있는 웹의 URL입니다.
NavigationNodeLocation	탐색 노드가 있는 위치를 보여 주는 탐색 노드 제목입니다. 여러 수준의 탐색 노드를 사용할 수 있으며, 그러면 잘못된 노드를 찾는 데 도움이 됩니다.
NavigationNodeTitle	영향을 받은 탐색 노드의 제목입니다.
NavigationNodeURL	사이트 이름 변경 후 너무 길어질 URL입니다.
ScanID	SharePoint 마이그레이션 평가 도구의 특정 실행에 할당된 고유 식별자입니다.

LongODBUrl-Perms-detail.csv SharePoint의 개체에 대해 설정된 권한을 해당 개체의 URL로 추적합니다. 폴더에 대한 사용 권한을 설정하면 SharePoint는 폴더에 대한 상대 경로를 저장합니다. 항목에 대한 사용 권한을 설정하면 SharePoint는 항목에 대한 서버 상대 경로를 저장합니다.

따라서 사이트 마이그레이션 중 권한과 연결된 URL이 업데이트됩니다. 새 URL이 너무 긴 경우 오류가 발생할 수 있습니다.

이 문제를 해결하려면 영향을 받는 개체를 사이트 모음의 루트에 더 가깝게 이동합니다. 또 다른 옵션으로 보고서의 항목에서 고유한 권한을 제거합니다.

열	설명
SiteId	영향을 받는 사이트 모음의 고유 식별자입니다.
SiteURL	영향을 받는 사이트 모음으로 이동하는 URL입니다.
SiteOwner	사이트 모음의 소유자입니다.
SiteAdmins	사이트 모음 관리자로 나열된 사용자의 목록입니다.
SiteSizeInMB	메가바이트[MB] 단위의 사이트 모음 크기입니다.
NumOfWebs	사이트 모음에 있는 웹 수입니다.
ContentDBName	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 이름입니다.
ContentDBServerName	데이터베이스 콘텐츠를 호스트하는 SQL Server입니다.
ContentDBSizeInMB	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 크기입니다.
UPN	URL 길이의 차이를 확인하는 데 사용된 UserPrincipalName입니다. UPN이 "****"인 경우 소유자가 SharePoint 프로필에 UserPrincipalName을 설정하지 않았음을 나타냅니다. 따라서 SharePoint 프로필 저장소에 있는 UserPrincipalName의 평균 길이가 사용되었습니다.
URLLengthDifference	사이트의 이름을 바꾸는 경우 URL이 늘어나는 크기입니다.
WebURL	보안된 개체를 호스트하는 웹의 URL입니다.
SecuredObject	사이트 이름 변경 후 너무 길어질 보안된 개체의 URL입니다. 파일에 권한을 추가하는 경우 파일의 서버 상대 경로입니다. 폴더에 대한 권한을 설정하는 경우 폴더의 서버 상대 경로입니다.
ScanID	SharePoint 마이그레이션 평가 도구의 특정 실행에 할당된 고유 식별자입니다.

LongODBUrl-Deps-detail.csv 특정 파일에는 다른 종속성이 있을 수 있습니다. 이러한 종속성을 URL로 추적합니다. 마이그레이션 중에 종속성 정보가 너무 길면 마이그레이션이 실패합니다.

이 보고서에서 다음과 같은 두 가지 제한을 잘 알고 있어야 합니다.

• FullURL의 한도는 260자입니다. 종속성이 있는 파일입니다. FullURL이 너무 긴 경우 수정하려면 파일을 제거하거나 사이트 모음의 루트에 가까운 위치로 파일을 이동합니다.

• DependencyDescription의 제한은 270자입니다. FullURL과 연결된 종속성입니다. DependencyDescription을 수정하려면 종속성을 제거하거나 종속성을 사이트 모음의 루트에 더 가깝게 이동합니다.

열	설명
SiteId	영향을 받는 사이트 모음의 고유 식별자입니다.
SiteURL	영향을 받는 사이트 모음으로 이동하는 URL입니다.
SiteOwner	사이트 모음의 소유자입니다.
SiteAdmins	사이트 모음 관리자로 나열된 사용자의 목록입니다.
SiteSizeInMB	메가바이트[MB] 단위의 사이트 모음 크기입니다.
NumOfWebs	사이트 모음에 있는 웹 수입니다.
ContentDBName	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 이름입니다.
ContentDBServerName	데이터베이스 콘텐츠를 호스트하는 SQL Server입니다.
ContentDBSizeInMB	사이트 모음을 호스트하는 콘텐츠 데이터베이스의 크기입니다.
UPN	URL 길이의 차이를 확인하는 데 사용된 UPN입니다. UPN이 "****"인 경우 소유자가 SharePoint 프로필에 UserPrincipalName을 설정하지 않았음을 나타냅니다. 따라서 SharePoint 프로필 저장소에 있는 UserPrincipalName의 평균 길이가 사용되었습니다.
URLLengthDifference	사이트의 이름을 바꾸는 경우 URL이 늘어나는 크기입니다.
FullURL	종속성이 있는 파일의 URL입니다.
DependencyDescription	종속성과 연결된 DependencyDescription 설명입니다. 이름을 변경할 URL이 될 수 있습니다.
ScanID	SharePoint 마이그레이션 평가 도구의 특정 실행에 할당된 고유 식별자입니다.