Оценочная проверка миграции: длинные URL-адреса OneDrive
Узнайте, как устранять проблемы с длинными URL-адресами OneDrive в ходе миграции.
Общие сведения
При перемещении сайта OneDrive из исходной среды в целевую среду URL-адрес OneDrive изменяется в форматах. На исходной платформе сайты OneDrive имеют формат https://onedrive.contoso.com/personal/domain_user. На целевой платформе Domain_User часть URL-адреса изменяется, чтобы использовать имя участника-пользователя для пользователя. Это выглядит примерно так: 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-адрес теперь на четыре символа длиннее, чем раньше. В зависимости от того, как формируются имена участников-пользователей в вашей организации, длина URL-адреса может измениться еще больше.
Если в исходной среде предыдущий файл содержал 255 символов, его длина после миграции будет составлять 259 символов.
Мы определили четыре разных расположения, в которых могут произойти сбои из-за длинных URL-адресов. В результате у нас есть четыре разных отчета о длинных URL-адресах. В разделе "Отчеты о результатах проверки" приведены все отчеты вместе со сведениями о необходимых исправлениях.
Перенос данных
Миграция исходного содержимого приводит к сбою длинных URL-адресов. Это приводит к сбою заданий миграции, что приведет к без необходимости продлению проекта миграции.
Важно!
Любой сайт, настроенный как "Нет доступа" (заблокирован) в SharePoint, будет пропущен. Список заблокированных семейств веб-сайтов см. в выходных данных сканирования заблокированных сайтов.
Подготовка к миграции
Ознакомьтесь с отчетами и выполните исправления, рекомендуемые в каждом из них. Как правило, исправления состоит в переносе содержимого ближе в корню семейства веб-сайтов.
Действия после переноса
Убедитесь в успешном переносе содержимого.
Отчеты о результатах сканирования
Эта проверка приводит к четырем выходным файлам. Каждый файл предназначен для конкретной проблемы с длинным 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-адрес теперь длиннее, чем раньше:
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 | Размер (в мегабайтах) семейства веб-сайтов. |
| NumOfWebs | Количество сетей в семействе веб-сайтов. |
| ContentDBName | Имя базы данных контента, в которой хранится семейство веб-сайтов. |
| ContentDBServerName | SQL Server, на котором размещена база данных контента. |
| ContentDBSizeInMB | Размер базы данных контента, в которой хранится семейство веб-сайтов. |
| LastContentModifiedDate | Дата и время изменения контента семейства веб-сайтов. |
| TotalItemCount | Общее количество элементов в семействе веб-сайтов. |
| Обращения | Количество зарегистрированных запросов для семейства веб-сайтов. Получено на основе данных службы ведения журнала использования. Если служба ведения журнала использования отключена, в этой строке отображается значение N/A. |
| DistinctUsers | Количество отдельных пользователей, обращавшихся к семейству веб-сайтов. Получено на основе данных службы ведения журнала использования. Если служба ведения журнала использования отключена, в этой строке отображается значение N/A. |
| DaysOfUsageData | Количество дней, в течение которых данные хранятся в службе ведения журнала использования. Обеспечивает контекст для значений Hits и DistinctUsers. Например, если в этом столбце указано 14 дней, в столбцах Hits и DistinctUsers отображаются данные за последние 14 дней. |
| Имя участника-пользователя | Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя имеет значение "***", что указывает, что владелец не имеет значения UserPrincipalName в профиле SharePoint. В результате была использована средняя длина значений UserPrincipalName в хранилище профилей SharePoint. |
| URLLengthDifference | Размер URL-адреса увеличивается при переименовании сайта. |
| Файл | Файл, который необходимо исправить. |
| ScanID | Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool. |
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 | Размер (в мегабайтах) семейства веб-сайтов. |
| NumOfWebs | Количество сетей в семействе веб-сайтов. |
| ContentDBName | Имя базы данных контента, в которой хранится семейство веб-сайтов. |
| ContentDBServerName | SQL Server, на котором размещена база данных контента. |
| ContentDBSizeInMB | Размер базы данных контента, в которой хранится семейство веб-сайтов. |
| Имя участника-пользователя | Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя имеет значение "***", что указывает, что владелец не имеет значения UserPrincipalName в профиле SharePoint. В результате была использована средняя длина значения UserPrincipalName в хранилище профилей SharePoint. |
| URLLengthDifference | URLLengthDifference — значение URL-адреса увеличивается при переименовании сайта. |
| WebURL | URL-адрес сайта, на котором размещен узел навигации. |
| NavigationNodeLocation | Названия узла навигации, показывающие его расположение. У вас может быть несколько уровней узлов навигации, что поможет найти проблемный узел. |
| NavigationNodeTitle | Название затронутого узла навигации. |
| NavigationNodeURL | URL-адрес, длина которого будет слишком большой после переименования сайта. |
| ScanID | Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool. |
LongODBUrl-Perms-detail.csv Разрешения, заданные для объекта в SharePoint, отслеживаются по URL-адресу этого объекта. Если вы задаете разрешения для папки, SharePoint сохраняет относительный путь к папке. Если вы задали разрешения для элемента, SharePoint сохраняет относительный путь к нему на сервере.
В результате связанные с этими разрешениями URL-адреса будут обновлены во время миграции. Если новый URL-адрес слишком длинный, это может привести к сбоям.
Эту проблему можно исправить, переместив затронутый объект ближе к корню семейства веб-сайтов. Вы также можете удалить уникальные разрешения для элементов в отчете.
| Столбец | Описание |
|---|---|
| SiteId | Уникальный идентификатор затронутого семейства веб-сайтов. |
| SiteURL | URL-адрес затронутого семейства веб-сайтов. |
| SiteOwner | Владелец семейства веб-сайтов. |
| SiteAdmins | Список администраторов семейства веб-сайтов. |
| SiteSizeInMB | Размер (в мегабайтах) семейства веб-сайтов. |
| NumOfWebs | Количество сетей в семействе веб-сайтов. |
| ContentDBName | Имя базы данных контента, в которой хранится семейство веб-сайтов. |
| ContentDBServerName | SQL Server, на котором размещена база данных контента. |
| ContentDBSizeInMB | Размер базы данных контента, в которой хранится семейство веб-сайтов. |
| Имя участника-пользователя | Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя имеет значение "***", что указывает, что владелец не имеет значения UserPrincipalName в профиле SharePoint. В результате была использована средняя длина значения UserPrincipalName в хранилище профилей SharePoint. |
| URLLengthDifference | Число символов, на которое увеличится URL-адрес после переименования сайта. |
| WebURL | URL-адрес веб-сайта, на котором размещается защищенный объект. |
| SecuredObject | URL-адрес защищенного объекта, длина которого будет слишком большой после переименования сайта. Если вы задаете разрешения для файла, этот URL-адрес относительный путь сервера к файлу. При задании разрешений для папки этот URL-адрес является относительным путем сервера к папке. |
| ScanID | Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool. |
LongODBUrl-Deps-detail.csv Некоторые файлы могут иметь другие зависимости. Эти зависимости отслеживаются по URL-адресу. Если сведения о зависимостях слишком длинные, во время миграции происходит сбой.
В этом отчете следует учитывать два ограничения:
Ограничение длины для параметра FullURL 260 символов. Это файл с зависимостями. Если значение FullURL слишком длинное, удалите файл или переместите его в расположение ближе в корню семейства веб-сайтов.
Ограничение длины для параметра DependencyDescription 270 символов. Это зависимость, связанная с параметром FullURL. Если значение DependencyDescription слишком длинное, удалите файл или переместите его в расположение ближе в корню семейства веб-сайтов.
| Столбец | Описание |
|---|---|
| SiteId | Уникальный идентификатор затронутого семейства веб-сайтов. |
| SiteURL | URL-адрес затронутого семейства веб-сайтов. |
| SiteOwner | Владелец семейства веб-сайтов. |
| SiteAdmins | Список администраторов семейства веб-сайтов. |
| SiteSizeInMB | Размер (в мегабайтах) семейства веб-сайтов. |
| NumOfWebs | Количество сетей в семействе веб-сайтов. |
| ContentDBName | Имя базы данных контента, в которой хранится семейство веб-сайтов. |
| ContentDBServerName | SQL Server, на котором размещена база данных контента. |
| ContentDBSizeInMB | Размер базы данных контента, в которой хранится семейство веб-сайтов. |
| Имя участника-пользователя | Имя участника-пользователя, определявшее разницу в длине URL-адреса. Если имя участника-пользователя имеет значение "***", это означает, что владелец не имеет userPrincipalName в профиле SharePoint. В результате была использована средняя длина значения UserPrincipalName в хранилище профилей SharePoint. |
| URLLengthDifference | Число символов, на которое увеличится URL-адрес после переименования сайта. |
| FullURL | URL-адрес файла с зависимостями. |
| DependencyDescription | Описание, связанное с зависимостью. Это может быть URL-адрес, который переименовывается. |
| ScanID | Уникальный идентификатор, назначаемый определенному выполнению средства SharePoint Migration Assessment Tool. |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по