Análise da Avaliação de Migração: URLs longas do OneDrive

Artigo
04/07/2023

Saiba como corrigir problemas com URLs longas do OneDrive durante a migração.

Visão geral

Quando você está movendo um site do OneDrive de sua origem para o ambiente de destino, a URL do OneDrive muda de formato. Na plataforma de origem, os sites do OneDrive estão no formato de https://onedrive.contoso.com/personal/domain_user. Na plataforma de destino, a parte Domain_User da URL é alterada para usar o UPN para o usuário. Isso é semelhante a https://onedrive.contoso.com/personal/user_contoso_com.

Exemplo:

Se você usou este arquivo:

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

O nome do diretório do arquivo seria:

Personal/contoso_bobsmith/Documents/Folder1/Folder2

Observação

Há um limite de 400 caracteres no caminho do diretório para um arquivo no SharePoint.

Após a migração, o caminho do arquivo parecerá o seguinte.

Personal/bobsmith_contoso_com/Documents/Folder1/Folder2

Observe que a URL agora tem quatro caracteres a mais do que era antes. Dependendo de como os UPNs são formados em sua empresa, a mudança de tamanho pode ser maior.

Se o arquivo anterior no ambiente de origem fosse de 255 caracteres, o tamanho após a migração seria de 259 caracteres.

Identificamos quatro locais diferentes em que as falhas provavelmente ocorrerão devido a URLs longas. Como resultado, temos quatro relatórios diferentes sobre URLs longas. A seção Relatórios com o resultado da verificação cobre cada relatório juntamente com a correção que precisa ocorrer.

Migração de dados

A migração do conteúdo de origem que resulta na falha das URLs longas. Isso faz com que os trabalhos de migração falhem, o que prolongará o projeto de migração desnecessariamente.

Importante

[!IMPORTANTE] Qualquer site que esteja configurado como "Sem acesso" (bloqueado) no SharePoint será ignorado. Para ver uma lista de conjuntos de sites bloqueados, veja o resultado da varredura dos Sites Bloqueados.

Preparação para a migração

Revise os relatórios e siga a correção recomendada para cada relatório. Em geral, a correção envolve mover o conteúdo mais próximo da raiz do conjunto de sites.

Pós-migração

Valide que seu conteúdo foi migrado.

Relatórios com o resultado da verificação

Essa verificação resulta em quatro arquivos de saída. Cada arquivo é para uma questão de URL longa específica que resultará em falhas de migração. LongODBUrl-AllDocs-detail.csv Existem duas limitações relacionadas ao tamanho do caminho para um determinado arquivo:

O caminho relativo do servidor para a pasta que contém o arquivo tem um máximo de 400 caracteres. Usando o seguinte exemplo de arquivo:

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

O nome do diretório seria o seguinte: Personal/contoso_bobsmith/Documents/Folder1/Folder2.

Após a migração, o caminho do arquivo parecerá o seguinte. Observe que a URL agora é mais longa do que era antes: Personal/bobsmith_contoso_com/Documents/Folder1/Folder2.
O caminho relativo do servidor para um arquivo ou pasta tem um total de 400 caracteres. Usando o seguinte exemplo de arquivo:

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

O caminho relativo do servidor para o arquivo é semelhante ao seguinte: Pessoal/contoso_bobsmith/Documentos/Folder1/Folder2/ProjectA.docx

Se houver arquivos listados neste relatório, os proprietários precisarão mover os arquivos para caminhos mais curtos ou excluir os arquivos. Por exemplo, eles podem mover ProjectA.docx para uma pasta diretamente em Documentos ou podem excluir o arquivo se ele não for mais necessário.

Coluna	Descrição
SiteId	Identificador exclusivo do conjunto de sites afetados.
SiteURL	URL para o conjunto de sites afetados.
SiteOwner	Proprietário do conjunto de sites.
SiteAdmins	Lista de pessoas listadas como administradores de conjuntos de sites.
SiteSizeInMB	Tamanho em megabytes (MB) do conjunto de sites.
NumOfWebs	Número de webs que existem no conjunto de sites.
ContentDBName	Nome do banco de dados de conteúdo que hospeda o conjunto de sites.
ContentDBServerName	SQL Server que hospeda o banco de dados de conteúdo.
ContentDBSizeInMB	Tamanho do banco de dados de conteúdo que hospeda o conjunto de sites.
LastContentModifiedDate	Data/Hora em que o conjunto de sites teve o conteúdo modificado.
TotalItemCount	Número total de itens encontrados no conjunto de sites.
Acertos	Número de solicitações registradas em log para o conjunto de sites. Depende de dados do serviço de registro de uso. Se o serviço de log de uso estiver desabilitado, essa linha mostrará N/A.
DistinctUsers	Número de usuários distintos que acessaram o conjunto de sites. Depende de dados do serviço de registro de uso. Se o serviço de log de uso estiver desabilitado, essa linha mostrará N/A.
DaysOfUsageData	Número de dias que o serviço de registro de uso retém dados. Isso fornece contexto para Hits e DistinctUsers. Por exemplo, se for 14 dias, os dados de Hits e DistinctUsers são dos últimos 14 dias.
UPN	UPN que foi usado para determinar a diferença no tamanho da URL. Se o UPN for "****" que indica que o proprietário não tinha um UserPrincipalName definido em seu perfil do SharePoint. Como resultado, o tamanho médio dos valores do UserPrincipalName no armazenamento de perfis do SharePoint foi usado.
URLLengthDifference	Valor que a URL cresce quando o site é renomeado.
Arquivo	Arquivo que precisa ser corrigido.
ScanID	Identificador exclusivo atribuído a uma execução específica da Ferramenta de Avaliação de Migração do SharePoint.

LongODBUrl-NavNodes-detail.csv Os nós de navegação possuem uma limitação de tamanho de URL de 260 caracteres. Isso pode fazer com que o campo da URL exceda o tamanho máximo.

Por exemplo, você tem um site OneDrive em https://OneDrive.contoso.com/personal/contoso_bobsmith. Este site tem um link no Início Rápido chamado de Relatórios e a URL do link aponta para https://onedrive.contoso.com/personal/contoso_bobsmith/documents/folder1/...folderN/Reports. Durante a migração, o SharePoint atualiza a URL para apontar para /bobsmith_contoso_com/. O comprimento extra adicionado à URL pode resultar na duração de mais de 260 caracteres, o que fará com que a migração falhe.

Para corrigir este problema, você moveria a pasta de relatórios para perto da raiz da biblioteca /documentos/ e depois atualizaria o link de Início Rápido. Outra opção seria remover o link de início rápido.

Coluna	Descrição
SiteId	Identificador exclusivo do conjunto de sites afetados.
SiteURL	URL para o conjunto de sites afetados.
SiteOwner	Proprietário do conjunto de sites.
SiteAdmins	Lista de pessoas listadas como administradores de conjuntos de sites.
SiteSizeInMB	Tamanho em megabytes (MB) do conjunto de sites.
NumOfWebs	Número de webs que existem no conjunto de sites.
ContentDBName	Nome do banco de dados de conteúdo que hospeda o conjunto de sites.
ContentDBServerName	SQL Server que hospeda o banco de dados de conteúdo.
ContentDBSizeInMB	Tamanho do banco de dados de conteúdo que hospeda o conjunto de sites.
UPN	UPN que foi usado para determinar a diferença no tamanho da URL. Se o UPN for "****" que indica que o proprietário não tinha um UserPrincipalName definido em seu perfil do SharePoint. Como resultado, o tamanho médio do UserPrincipalName no armazenamento de perfis do SharePoint foi usado.
URLLengthDifference	URLLengthDifference Amount a URL cresce quando o site é renomeado.
WebURL	URL para a web que possui o nó de navegação.
NavigationNodeLocation	Títulos do nó de navegação mostrando onde o nó de navegação mora. Você pode ter vários níveis de nós de navegação, o que ajudará a localizar o nó ofensivo.
NavigationNodeTitle	Título do nó de navegação afetado.
NavigationNodeURL	URL que será muito longa após a renomeação do site.
ScanID	Identificador exclusivo atribuído a uma execução específica da Ferramenta de Avaliação de Migração do SharePoint.

LongODBUrl-Perms-detail.csv As permissões que são definidas em um objeto no SharePoint são rastreadas pela URL desse objeto. Se você definir permissões em uma pasta, o SharePoint armazenará o caminho relativo para a pasta. Se você definir permissões em um item, o SharePoint armazenará o caminho relativo do servidor para o item.

Como resultado, durante uma migração do site, as URLs associadas às permissões serão atualizadas. Isso pode levar a falhas se a nova URL for muito longa.

A correção para isso é mover o objeto afetado para mais perto da raiz do conjunto de sites. Outra opção é remover as permissões distintas dos itens no relatório.

Coluna	Descrição
SiteId	Identificador exclusivo do conjunto de sites afetados.
SiteURL	URL para o conjunto de sites afetados.
SiteOwner	Proprietário do conjunto de sites.
SiteAdmins	Lista de pessoas listadas como administradores de conjuntos de sites.
SiteSizeInMB	Tamanho em megabytes (MB) do conjunto de sites.
NumOfWebs	Número de webs que existem no conjunto de sites.
ContentDBName	Nome do banco de dados de conteúdo que hospeda o conjunto de sites.
ContentDBServerName	SQL Server que hospeda o banco de dados de conteúdo.
ContentDBSizeInMB	Tamanho do banco de dados de conteúdo que hospeda o conjunto de sites.
UPN	UserPrincipalName do UPN que foi usado para determinar a diferença no tamanho da URL. Se o UPN for "****" que indica que o proprietário não tinha um UserPrincipalName definido em seu perfil do SharePoint. Como resultado, o tamanho médio do UserPrincipalName no armazenamento de perfis do SharePoint foi usado.
URLLengthDifference	Valor que a URL terá quando o site for renomeado.
WebURL	URL para a web que hospeda o objeto protegido.
SecuredObject	Este é a URL para o objeto protegido que será muito longa após o site ser renomeado. Se você adicionar permissões a um arquivo, este é o caminho relativo do servidor para o arquivo. Se você definir permissões em uma pasta, este é o caminho relativo do servidor para a pasta.
ScanID	Identificador exclusivo atribuído a uma execução específica da Ferramenta de Avaliação de Migração do SharePoint.

LongODBUrl-Deps-detail.csv Determinados arquivos podem ter outras dependências. Essas dependências são rastreadas pela URL. Durante a migração, se as informações de dependência forem muito longas, a migração falhará.

Existem duas limitações nesse relatório a serem consideradas:

FullURL tem um limite de 260 caracteres. Este é o arquivo com as dependências. Para corrigir se o FullURL for muito longo, remova o arquivo ou mova o arquivo para um local mais próximo da raiz do conjunto de sites.
DependencyDescription tem um limite de 270 caracteres. Esta é a dependência associada ao FullURL. Para corrigir o DependencyDescription, remova a dependência ou mova a dependência para mais perto da raiz do conjunto de sites.

Coluna	Descrição
SiteId	Identificador exclusivo do conjunto de sites afetados.
SiteURL	URL para o conjunto de sites afetados.
SiteOwner	Proprietário do conjunto de sites.
SiteAdmins	Lista de pessoas listadas como administradores de conjuntos de sites.
SiteSizeInMB	Tamanho em megabytes (MB) do conjunto de sites.
NumOfWebs	Número de webs que existem no conjunto de sites.
ContentDBName	Nome do banco de dados de conteúdo que hospeda o conjunto de sites.
ContentDBServerName	SQL Server que hospeda o banco de dados de conteúdo.
ContentDBSizeInMB	Tamanho do banco de dados de conteúdo que hospeda o conjunto de sites.
UPN	UPN que foi usado para determinar a diferença no tamanho da URL. Se o UPN for "****", isso indica que o proprietário não tinha um UserPrincipalName definido em seu perfil do SharePoint. Como resultado, o tamanho médio do UserPrincipalName no armazenamento de perfis do SharePoint foi usado.
URLLengthDifference	Valor que a URL terá quando o site for renomeado.
FullURL	URL para o arquivo que possui as dependências
DependencyDescription	DependencyDescription Descrição associada à dependência. Isso pode ser uma URL que está sendo renomeada.
ScanID	Identificador exclusivo atribuído a uma execução específica da Ferramenta de Avaliação de Migração do SharePoint.

Partilhar via