Como gerenciar arquivos hierárquicos

Este artigo fornece orientação para usuários que têm dúvidas relacionadas ao gerenciamento de arquivos hierárquicos. Para perguntas conceituais sobre a hierarquização na nuvem, consulte Perguntas frequentes sobre arquivos do Azure.

Como verificar se os ficheiros estão a ser colocados em camadas

Se os arquivos precisam ou não ser hierarquizados por políticas definidas é avaliado uma vez por hora. Você pode se deparar com duas situações quando um novo ponto de extremidade do servidor é criado:

1. Quando você adiciona um novo ponto de extremidade do servidor pela primeira vez, geralmente os arquivos existem nesse local do servidor. Eles precisam ser carregados antes que a hierarquização na nuvem possa começar. A política de espaço livre de volume não começará seu trabalho até que o carregamento inicial de todos os arquivos tenha terminado. No entanto, a política de data opcional começará a funcionar em uma base de arquivo individual, assim que um arquivo for carregado. O intervalo de uma hora também se aplica aqui.

2. Quando você adiciona um novo ponto de extremidade de servidor, é possível que você tenha conectado um local de servidor vazio a um compartilhamento de arquivos do Azure com seus dados nele. Se você optar por baixar o namespace e recuperar o conteúdo durante o download inicial para o servidor, depois que o namespace cair, os arquivos serão recuperados com base no carimbo de data/hora da última modificação até que a política de espaço livre de volume e os limites da política de data opcional sejam atingidos.

Há várias maneiras de verificar se um arquivo foi hierarquizado para seu compartilhamento de arquivos do Azure:

• Verifique os atributos do arquivo no arquivo. Clique com o botão direito do mouse em um arquivo, vá para Detalhes e role para baixo até a propriedade Atributos . Um arquivo hierárquico tem os seguintes atributos definidos:

  Carta de atributo	Atributo	Definição
  A	Arquivo	Indica que o backup do arquivo deve ser feito pelo software de backup. Esse atributo é sempre definido, independentemente de o arquivo ser hierarquizado ou armazenado totalmente no disco.
  P	Arquivo esparso	Indica que o arquivo é um arquivo esparso. Um arquivo esparso é um tipo especializado de arquivo que o NTFS oferece para uso eficiente quando o arquivo no fluxo de disco está praticamente vazio. A Sincronização de Arquivos do Azure usa arquivos esparsos porque um arquivo é totalmente hierarquizado ou parcialmente recuperado. Em um arquivo totalmente hierárquico, o fluxo de arquivos é armazenado na nuvem. Em um arquivo parcialmente recuperado, essa parte do arquivo já está no disco. Isso pode ocorrer quando os arquivos são parcialmente lidos por aplicativos como players multimídia ou utilitários zip. Se um arquivo for totalmente recuperado para o disco, o Azure File Sync o converterá de um arquivo esparso em um arquivo normal. Este atributo só é definido no Windows Server 2016 e versões anteriores.
  Seg	Recall sobre o acesso aos dados	Indica que os dados do arquivo não estão totalmente presentes no armazenamento local. A leitura do arquivo fará com que pelo menos parte do conteúdo do arquivo seja buscado de um compartilhamento de arquivos do Azure ao qual o ponto de extremidade do servidor está conectado. Este atributo só é definido no Windows Server 2019 e mais recente.
  L	Ponto de reanálise	Indica que o arquivo tem um ponto de análise. Um ponto de análise é um ponteiro especial para uso por um filtro do sistema de arquivos. O Azure File Sync usa pontos de análise para definir para o filtro do sistema de arquivos do Azure File Sync (StorageSync.sys) o local da nuvem onde o arquivo está armazenado. Isso suporta acesso contínuo. Os usuários não precisarão saber que o Azure File Sync está sendo usado ou como obter acesso ao arquivo em seu compartilhamento de arquivos do Azure. Quando um arquivo é totalmente recuperado, a Sincronização de Arquivos do Azure remove o ponto de análise do arquivo.
  O	Offline	Indica que parte ou todo o conteúdo do arquivo não está armazenado no disco. Quando um arquivo é totalmente recuperado, a Sincronização de Arquivos do Azure remove esse atributo.

  

  Nota

  Você pode ver os atributos de todos os arquivos em uma pasta adicionando o campo Atributos à exibição de tabela do Explorador de Arquivos. Para fazer isso, clique com o botão direito do mouse em uma coluna existente (por exemplo, Tamanho), selecione Mais e, em seguida, selecione Atributos na lista suspensa.

  Nota

  Todos esses atributos também serão visíveis para arquivos parcialmente recuperados.

• Use fsutil para verificar pontos de análise em um arquivo. Conforme descrito na opção anterior, um arquivo em camadas sempre tem um ponto de análise definido. Um ponto de análise permite que o driver de filtro do sistema de arquivos (StorageSync.sys) do Azure File Sync recupere conteúdo de compartilhamentos de arquivos do Azure que não está armazenado localmente no servidor.

  Para verificar se um arquivo tem um ponto de análise, em uma janela elevada do Prompt de Comando ou do PowerShell, execute o fsutil utilitário:

  fsutil reparsepoint query <your-file-name>
  

  Se o arquivo tiver um ponto de análise, você pode esperar ver Valor da tag de reparo: 0x8000001e. Esse valor hexadecimal é o valor de ponto de análise de propriedade da Sincronização de Arquivos do Azure. A saída também contém os dados de análise que representam o caminho para seu arquivo em seu compartilhamento de arquivos do Azure.

  Aviso

  O fsutil reparsepoint comando utility também tem a capacidade de excluir um ponto de reparo. Não execute este comando a menos que a equipe de engenharia do Azure File Sync solicite. A execução deste comando pode resultar em perda de dados.

Como excluir ficheiros ou pastas de serem colocados em camadas

Se desejar excluir arquivos ou pastas de serem hierarquizados e permanecer locais no Windows Server, você pode configurar a configuração do Registro GhostingExclusionList em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync. Você pode excluir arquivos por nome de arquivo, extensão de arquivo ou caminho.

Para excluir arquivos ou pastas da hierarquização da nuvem, execute as seguintes etapas:

1. Abra uma linha de comandos elevada.

2. Execute um dos seguintes comandos para configurar exclusões:

   Para excluir determinadas extensões de arquivo da hierarquização (por exemplo, .one, .lnk, .log), execute o seguinte comando:
   reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d .one|. LNK|. log /f

   Para excluir um nome de arquivo específico da hierarquização (por exemplo, FileName.vhd), execute o seguinte comando:
   reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d FileName.vhd /f

   Para excluir todos os arquivos de uma pasta da hierarquização (por exemplo, D:\ShareRoot\Folder\SubFolder), execute o seguinte comando: reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\ShareRoot\\Folder\\SubFolder /f

   Para excluir uma combinação de nomes de arquivo, extensões de arquivo e pastas da hierarquização (por exemplo, D:\ShareRoot\Folder1\SubFolder1,FileName.log,.txt), execute o seguinte comando:
   reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\ShareRoot\\Folder1\\SubFolder1|FileName.log|. txt /f

3. Para que as exclusões de hierarquização na nuvem entrem em vigor, reinicie o serviço Storage Sync Agent (FileSyncSvc) executando os seguintes comandos:
   net stop filesyncsvc
   net iniciar filesyncsvc

Downloads hierárquicos

Quando você exclui um tipo ou padrão de arquivo, ele não será mais hierarquizado desse servidor. No entanto, todos os arquivos alterados ou criados em um ponto de extremidade diferente continuarão a ser baixados como arquivos hierárquicos e permanecerão hierárquicos. Estes ficheiros serão recolhidos gradualmente com base na política de exclusão.

Por exemplo, se você excluir arquivos PDF, os arquivos PDF criados diretamente no servidor não serão hierarquizados. No entanto, todos os arquivos PDF criados em um ponto de extremidade diferente, como outro ponto de extremidade do servidor ou o compartilhamento de arquivos do Azure, ainda serão baixados como arquivos em camadas. Esses arquivos hierárquicos excluídos serão totalmente recuperados nos próximos 3 a 4 dias.

Se você não quiser que nenhum arquivo esteja em um estado hierárquico, habilite a recuperação proativa. Esse recurso impedirá o download em camadas de todos os arquivos e interromperá a hierarquização em segundo plano.

Mais informações

• Se o agente do Azure File Sync estiver instalado em um Cluster de Failover, você deverá criar a configuração do Registro GhostingExclusionList em HKEY_LOCAL_MACHINE\Cluster\StorageSync\SOFTWARE\Microsoft\Azure\StorageSync.
  • Exemplo: reg ADD "HKEY_LOCAL_MACHINE\Cluster\StorageSync\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d .one|. LNK|. log /f
• Cada exclusão no registo deve ser separada por um caractere pipe (|).
• Use barra invertida dupla (\\) ao especificar um caminho a ser excluído.
  • Exemplo: reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v GhostingExclusionList /t REG_SZ /d D:\\ShareRoot\\Folder\\SubFolder /f
• As exclusões de nome ou tipo de arquivo se aplicam a todos os pontos de extremidade do servidor no servidor.
• Não é possível excluir tipos de arquivo somente de uma pasta específica.
• As exclusões não se aplicam a arquivos já hierarquizados. Use o cmdlet Invoke-StorageSyncFileRecall para recuperar arquivos já hierarquizados.
• Use a ID de Evento 9001 no log de eventos de Telemetria no servidor para verificar as exclusões de hierarquização na nuvem configuradas. O log de eventos de Telemetria está localizado no Visualizador de Eventos em Applications and Services\Microsoft\FileSync\Agent.

Como excluir aplicações do controlo de tempo de acesso no arrumo na cloud

Quando um aplicativo acessa um arquivo, a última hora de acesso para o arquivo é atualizada no banco de dados de camadas na nuvem. Aplicativos que verificam o sistema de arquivos como antivírus fazem com que todos os arquivos tenham o mesmo tempo de último acesso, o que afeta quando os arquivos são hierarquizados.

Para excluir aplicativos do controle do último tempo de acesso, adicione as exclusões de processo à configuração do Registro HeatTrackingProcessNamesExclusionList em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync.

Exemplo: reg ADD "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync" /v HeatTrackingProcessNamesExclusionList /t REG_SZ /d "SampleApp.exe|AnotherApp.exe" /f

Se o agente do Azure File Sync estiver instalado em um Cluster de Failover, a configuração do Registro HeatTrackingProcessNamesExclusionList deverá ser criada em HKEY_LOCAL_MACHINE\Cluster\StorageSync\SOFTWARE\Microsoft\Azure\StorageSync.

Exemplo: reg ADD "HKEY_LOCAL_MACHINE\Cluster\StorageSync\SOFTWARE\Microsoft\Azure\StorageSync" /v HeatTrackingProcessNamesExclusionList /t REG_SZ /d "SampleApp.exe|AnotherApp.exe" /f

Como aceder ao arquivo camada de acesso frequente

A hierarquização na nuvem usa a última hora de acesso e a frequência de acesso de um arquivo para determinar quais arquivos devem ser hierarquizados. O driver de filtro de hierarquização na nuvem (storagesync.sys) rastreia o tempo do último acesso e registra as informações no armazenamento de calor de hierarquização na nuvem. Você pode recuperar o armazenamento de calor e salvá-lo em um arquivo CSV usando um cmdlet do PowerShell local do servidor.

Há um único armazenamento de calor para todos os arquivos no mesmo volume. O armazenamento de calor pode ficar muito grande. Se você só precisa recuperar o número "mais legal" de itens, use -Limit e um número e também considere filtrar por um subcaminho versus a raiz do volume.

• Importe o módulo do PowerShell: Import-Module '<SyncAgentInstallPath>\StorageSync.Management.ServerCmdlets.dll'

• ESPAÇO LIVRE DE VOLUME: Para obter a ordem em que os arquivos serão hierarquizados usando a política de espaço livre de volume: Get-StorageSyncHeatStoreInformation -VolumePath '<DriveLetter>:\' -ReportDirectoryPath '<FolderPathToStoreResultCSV>' -IndexName FilesToBeTieredBySpacePolicy

• POLÍTICA DE DATA: Para obter a ordem em que os arquivos serão hierarquizados usando a política de data: Get-StorageSyncHeatStoreInformation -VolumePath '<DriveLetter>:\' -ReportDirectoryPath '<FolderPathToStoreResultCSV>' -IndexName FilesToBeTieredByDatePolicy

• Encontre as informações de armazenamento de calor para um arquivo específico: Get-StorageSyncHeatStoreInformation -FilePath '<PathToSpecificFile>'

• Veja todos os ficheiros por ordem decrescente por hora do último acesso: Get-StorageSyncHeatStoreInformation -VolumePath '<DriveLetter>:\' -ReportDirectoryPath '<FolderPathToStoreResultCSV>' -IndexName DescendingLastAccessTime

• Veja a ordem pela qual os arquivos hierárquicos serão recuperados por recall em segundo plano ou por solicitação por meio do PowerShell: Get-StorageSyncHeatStoreInformation -VolumePath '<DriveLetter>:\' -ReportDirectoryPath '<FolderPathToStoreResultCSV>' -IndexName OrderTieredFilesWillBeRecalled

Como forçar um ficheiro ou um diretório a ser colocado em camadas

Quando o recurso de hierarquização na nuvem está habilitado, a hierarquização da nuvem hierarquiza automaticamente os arquivos com base no último acesso e modifica os tempos para atingir a porcentagem de espaço livre de volume especificada no ponto de extremidade da nuvem. Às vezes, você pode querer forçar manualmente um arquivo para a camada. Isso pode ser útil se você salvar um arquivo grande que não pretende usar novamente por muito tempo e quiser que o espaço livre no seu volume agora seja usado para outros arquivos e pastas. Você pode forçar a hierarquização usando os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Invoke-StorageSyncCloudTiering -Path <file-or-directory-to-be-tiered>

Como executar a revocação de um ficheiro em camadas no disco

A maneira mais fácil de recuperar um arquivo para o disco é abri-lo. O filtro do sistema de arquivos do Azure File Sync (StorageSync.sys) baixa o arquivo diretamente do seu compartilhamento de arquivos do Azure. Para tipos de arquivo que podem ser parcialmente lidos ou transmitidos, como arquivos multimídia ou .zip, simplesmente abrir um arquivo não garante que o arquivo inteiro seja baixado.

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll" 
Invoke-StorageSyncFileRecall -Path <path-to-to-your-server-endpoint> -Pattern *.lnk

Para garantir que um arquivo seja totalmente baixado para o disco local, você deve usar o PowerShell para forçar um arquivo a ser totalmente recuperado. Essa opção também pode ser útil se você quiser recuperar vários arquivos ao mesmo tempo, como todos os arquivos em uma pasta. Abra uma sessão do PowerShell no nó do servidor onde o Azure File Sync está instalado e execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Invoke-StorageSyncFileRecall -Path <path-to-to-your-server-endpoint>

Parâmetros opcionais:

• -Order CloudTieringPolicy recuperará primeiro os arquivos modificados ou acessados mais recentemente e é permitido pela política de hierarquização atual.
  • Se a política de espaço livre de volume estiver configurada, os arquivos serão recuperados até que a configuração da política de espaço livre de volume seja atingida. Por exemplo, se a configuração da política de livre volume for 20%, a recuperação será interrompida quando o espaço livre de volume atingir 20%.
  • Se a política de espaço livre de volume e data estiver configurada, os arquivos serão recuperados até que a configuração de política de espaço livre de volume ou data seja atingida. Por exemplo, se a configuração da política de livre volume for de 20% e a política de data for de 7 dias, a recuperação será interrompida quando o espaço livre de volume atingir 20% ou todos os arquivos acessados ou modificados dentro de 7 dias forem locais.
• -ThreadCount Determina quantos arquivos podem ser recuperados em paralelo (o limite de contagem de threads é 32).
• -PerFileRetryCount Determina a frequência com que será tentada uma recuperação de um arquivo que está bloqueado no momento.
• -PerFileRetryDelaySeconds determina o tempo, em segundos, entre as tentativas de repetição de recall e deve sempre ser usado em combinação com o parâmetro anterior.

Exemplo:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Invoke-StorageSyncFileRecall -Path <path-to-to-your-server-endpoint> -ThreadCount 8 -Order CloudTieringPolicy -PerFileRetryCount 3 -PerFileRetryDelaySeconds 10

Próximos passos

• Perguntas mais frequentes (FAQ) sobre os Ficheiros do Azure