Análise da Avaliação de Migração: URLs longas do OneDrive
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.docxO 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.docxO 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. |