Reparação de um trabalho de importaçãoRepairing an import job

O serviço de Importação/Exportação do Microsoft Azure pode não copiar alguns arquivos ou partes de um arquivo para o serviço Blob do Windows Azure.The Microsoft Azure Import/Export service may fail to copy some of your files or parts of a file to the Windows Azure Blob service. Alguns motivos para as falhas incluem:Some reasons for failures include:

  • Arquivos corrompidosCorrupted files

  • Unidades danificadasDamaged drives

  • A chave da conta de armazenamento mudou durante a transferência do arquivo.The storage account key changed while the file was being transferred.

Você pode executar a Ferramenta de Importação/Exportação do Microsoft Azure com os arquivos de log de cópia do trabalho de importação e a ferramenta carrega os arquivos ausentes (ou partes de um arquivo) em sua conta de armazenamento do Microsoft Azure para concluir o trabalho de importação.You can run the Microsoft Azure Import/Export Tool with the import job's copy log files, and the tool uploads the missing files (or parts of a file) to your Windows Azure storage account to complete the import job.

Parâmetros de RepairImportRepairImport parameters

Os seguintes parâmetros podem ser especificados com RepairImport:The following parameters can be specified with RepairImport:

/r: <RepairFile>/r:<RepairFile> Obrigatório.Required. Caminho até o arquivo de reparo, que controla o progresso do reparo e permite que você retome um reparo interrompido.Path to the repair file, which tracks the progress of the repair, and allows you to resume an interrupted repair. Cada unidade deve ter um, e somente um, arquivo de reparo.Each drive must have one and only one repair file. Ao iniciar o reparo de uma determinada unidade, você passa no caminho até um arquivo de reparo que ainda não existe.When you start a repair for a given drive, pass in the path to a repair file, which does not yet exist. Para retomar um reparo interrompido, você deve passar no nome de um arquivo de reparo existente.To resume an interrupted repair, you should pass in the name of an existing repair file. O arquivo de reparo que corresponde à unidade de destino deve sempre ser especificado.The repair file corresponding to the target drive must always be specified.
/logdir: <LogDirectory>/logdir:<LogDirectory> OpcionalOptional. O diretório de log.The log directory. Os arquivos de log detalhados são gravados nesse diretório.Verbose log files are written to this directory. Se nenhum diretório de log for especificado, o diretório atual será usado como o diretório de log.If no log directory is specified, the current directory is used as the log directory.
/d: <TargetDirectories>/d:<TargetDirectories> Obrigatório.Required. Um ou mais diretórios separados por ponto e vírgula que contêm os arquivos originais que foram importados.One or more semicolon-separated directories that contain the original files that were imported. A unidade de importação também pode ser usada, mas não será necessária se houver locais alternativos dos arquivos originais.The import drive may also be used, but is not required if alternate locations of original files are available.
/bk: <BitLockerKey>/bk:<BitLockerKey> OpcionalOptional. Você deve especificar a chave do BitLocker se quiser que a ferramenta desbloqueie uma unidade criptografada na qual os arquivos originais estão disponíveis.You should specify the BitLocker key if you want the tool to unlock an encrypted drive where the original files are available.
/sn: <StorageAccountName>/sn:<StorageAccountName> Obrigatório.Required. O nome da conta de armazenamento do trabalho de importação.The name of the storage account for the import job.
/sk: <StorageAccountKey>/sk:<StorageAccountKey> Necessário somente se uma SAS do contêiner não for especificada.Required if and only if a container SAS is not specified. A chave de conta da conta de armazenamento do trabalho de importação.The account key for the storage account for the import job.
/csas: <ContainerSas>/csas:<ContainerSas> Necessário somente se a chave da conta de armazenamento não for especificada.Required if and only if the storage account key is not specified. O SAS do contêiner para acessar os blobs associados ao trabalho de importação.The container SAS for accessing the blobs associated with the import job.
/CopyLogFile: <DriveCopyLogFile>/CopyLogFile:<DriveCopyLogFile> Obrigatório.Required. Caminho até o arquivo de log de cópia da unidade (log detalhado ou de erro).Path to the drive copy log file (either verbose log or error log). O arquivo é gerado pelo serviço de Importação/Exportação do Windows Azure e pode ser baixado do armazenamento de blobs associado ao trabalho.The file is generated by the Windows Azure Import/Export service and can be downloaded from the blob storage associated with the job. O arquivo de log de cópia contém informações sobre arquivos ou blobs com falha que devem ser reparados.The copy log file contains information about failed blobs or files, which are to be repaired.
/PathMapFile: <DrivePathMapFile>/PathMapFile:<DrivePathMapFile> OpcionalOptional. Caminho até um arquivo de texto que pode ser usado para resolver ambiguidades se você tiver vários arquivos com o mesmo nome que foram importados no mesmo trabalho.Path to a text file that can be used to resolve ambiguities if you have multiple files with the same name that you were importing in the same job. Na primeira vez que a ferramenta é executada, ela pode preencher esse arquivo com todos os nomes ambíguos.The first time the tool is run, it can populate this file with all of the ambiguous names. Execuções subsequentes da ferramenta usam esse arquivo para resolver as ambiguidades.Subsequent runs of the tool use this file to resolve the ambiguities.

Usando o comando RepairImportUsing the RepairImport command

Para reparar a dados de importação transmitindo os dados pela rede, você deve especificar os diretórios que contêm os arquivos originais importados usando o parâmetro /d.To repair import data by streaming the data over the network, you must specify the directories that contain the original files you were importing using the /d parameter. Você também deve especificar o arquivo de log de cópia que você baixou da sua conta de armazenamento.You must also specify the copy log file that you downloaded from your storage account. Uma linha de comando típica para reparar um trabalho de importação com falhas parciais é semelhante a:A typical command line to repair an import job with partial failures looks like:

WAImportExport.exe RepairImport /r:C:\WAImportExport\9WM35C2V.rep /d:C:\Users\bob\Pictures;X:\BobBackup\photos /sn:bobmediaaccount /sk:VkGbrUqBWLYJ6zg1m29VOTrxpBgdNOlp+kp0C9MEdx3GELxmBw4hK94f7KysbbeKLDksg7VoN1W/a5UuM2zNgQ== /CopyLogFile:C:\WAImportExport\9WM35C2V.log  

No exemplo a seguir de um arquivo de log de cópia, uma parte de 64 K de um arquivo foi corrompida na unidade enviada para o trabalho de importação.In the following example of a copy log file, one 64-K piece of a file was corrupted on the drive that was shipped for the import job. Como essa é a única falha indicada, o restante dos blobs no trabalho foi importado com êxito.Since this is the only failure indicated, the rest of the blobs in the job were successfully imported.

<?xml version="1.0" encoding="utf-8"?>  
<DriveLog>  
 <DriveId>9WM35C2V</DriveId>  
 <Blob Status="CompletedWithErrors">  
 <BlobPath>pictures/animals/koala.jpg</BlobPath>  
 <FilePath>\animals\koala.jpg</FilePath>  
 <Length>163840</Length>  
 <ImportDisposition Status="Overwritten">overwrite</ImportDisposition>  
 <PageRangeList>  
  <PageRange Offset="65536" Length="65536" Hash="AA2585F6F6FD01C4AD4256E018240CD4" Status="Corrupted" />  
 </PageRangeList>  
 </Blob>  
 <Status>CompletedWithErrors</Status>  
</DriveLog>  

Quando esse log de cópia for passado para a Ferramenta de Importação/Exportação do Azure, a ferramenta tenta concluir a importação desse arquivo copiando o conteúdo ausente pela rede.When this copy log is passed to the Azure Import/Export Tool, the tool tries to finish the import for this file by copying the missing contents across the network. Seguindo o exemplo acima, a ferramenta procura o arquivo original \animals\koala.jpg nos dois diretórios C:\Users\bob\Pictures e X:\BobBackup\photos.Following the example above, the tool looks for the original file \animals\koala.jpg within the two directories C:\Users\bob\Pictures and X:\BobBackup\photos. Se o arquivo C:\Users\bob\Pictures\animals\koala.jpg existir, a Ferramenta de Importação/Exportação do Azure copiará o intervalo de dados ausente no blob correspondente http://bobmediaaccount.blob.core.windows.net/pictures/animals/koala.jpg.If the file C:\Users\bob\Pictures\animals\koala.jpg exists, the Azure Import/Export Tool copies the missing range of data to the corresponding blob http://bobmediaaccount.blob.core.windows.net/pictures/animals/koala.jpg.

Resolvendo conflitos ao usar RepairImportResolving conflicts when using RepairImport

Em algumas situações, talvez a ferramenta não seja capaz de localizar ou abrir o arquivo necessário por um dos seguintes motivos: não foi possível encontrar o arquivo, o arquivo não está acessível, o nome do arquivo é ambíguo ou o conteúdo do arquivo não está correto.In some situations, the tool may not be able to find or open the necessary file for one of the following reasons: the file could not be found, the file is not accessible, the file name is ambiguous, or the content of the file is no longer correct.

Um erro ambíguo poderá ocorrer se a ferramenta estiver tentando localizar \animals\koala.jpg e houver um arquivo com esse nome em C:\Users\bob\pictures e X:\BobBackup\photos.An ambiguous error could occur if the tool is trying to locate \animals\koala.jpg and there is a file with that name under both C:\Users\bob\pictures and X:\BobBackup\photos. Ou seja, C:\Users\bob\pictures\animals\koala.jpg e X:\BobBackup\photos\animals\koala.jpg existem nas unidades do trabalho de importação.That is, both C:\Users\bob\pictures\animals\koala.jpg and X:\BobBackup\photos\animals\koala.jpg exist on the import job drives.

A opção /PathMapFile permite que você resolva esses erros.The /PathMapFile option allows you to resolve these errors. Você pode especificar o nome do arquivo que contém a lista de arquivos que a ferramenta não conseguiu identificar corretamente.You can specify the name of the file, which contains the list of files that the tool was not able to correctly identify. O exemplo de linha de comando a seguir preenche 9WM35C2V_pathmap.txt:The following command-line example populates 9WM35C2V_pathmap.txt:

WAImportExport.exe RepairImport /r:C:\WAImportExport\9WM35C2V.rep /d:C:\Users\bob\Pictures;X:\BobBackup\photos /sn:bobmediaaccount /sk:VkGbrUqBWLYJ6zg1m29VOTrxpBgdNOlp+kp0C9MEdx3GELxmBw4hK94f7KysbbeKLDksg7VoN1W/a5UuM2zNgQ== /CopyLogFile:C:\WAImportExport\9WM35C2V.log /PathMapFile:C:\WAImportExport\9WM35C2V_pathmap.txt  

Em seguida, a ferramenta gravará os caminhos do arquivo problemático em 9WM35C2V_pathmap.txt, um em cada linha.The tool will then write the problematic file paths to 9WM35C2V_pathmap.txt, one on each line. Por exemplo, o arquivo pode conter as seguintes entradas após a execução do comando:For instance, the file may contain the following entries after running the command:

\animals\koala.jpg  
\animals\kangaroo.jpg  

Para cada arquivo na lista, você deve tentar localizar e abrir o arquivo para garantir que ele esteja disponível para a ferramenta.For each file in the list, you should attempt to locate and open the file to ensure it is available to the tool. Se você quiser dizer à ferramenta explicitamente onde localizar um arquivo, modifique o arquivo de mapa do caminho e adicione o caminho a cada arquivo na mesma linha, separado por um caractere de tabulação:If you wish to tell the tool explicitly where to find a file, you can modify the path map file and add the path to each file on the same line, separated by a tab character:

\animals\koala.jpg           C:\Users\bob\Pictures\animals\koala.jpg  
\animals\kangaroo.jpg        X:\BobBackup\photos\animals\kangaroo.jpg  

Depois de disponibilizar os arquivos necessários para a ferramenta, ou atualizar o arquivo de mapa do caminho, execute novamente a ferramenta para concluir o processo de importação.After making the necessary files available to the tool, or updating the path map file, you can rerun the tool to complete the import process.

Próximas etapasNext steps