Preparando discos rígidos para um trabalho de importação
Para preparar um ou mais discos rígidos para um trabalho de importação, execute estas etapas:
Identificar os dados para importar no serviço Blob
Identificar os diretórios virtuais de destino e blobs no serviço Blob
Determinar quantas unidades você precisará
Copiar os dados para cada um de seus discos rígidos
Para obter um exemplo de fluxo de trabalho, confira Exemplo de fluxo de trabalho para preparar discos rígidos para um trabalho de importação.
Identificar os dados a serem importados
A primeira etapa para criar um trabalho de importação é determinar quais diretórios e arquivos você pretende importar. Isso pode ser uma lista de diretórios, uma lista de arquivos exclusivos ou uma combinação dos dois. Quando um diretório é incluído, todos os arquivos no diretório e seus subdiretórios farão parte do trabalho de importação.
Observação
Como os subdiretórios são incluídos recursivamente quando um diretório pai é incluído, especifique apenas o diretório pai. Não especifique nenhum de seus subdiretórios.
Atualmente, a Ferramenta de Importação/Exportação do Microsoft Azure tem a seguinte limitação: se um diretório contiver mais dados do que um disco rígido pode conter, o diretório precisará ser dividido em diretórios menores. Por exemplo, se um diretório contiver 2,5 TB de dados e a capacidade do disco rígido for apenas 2 TB, será necessário dividir o diretório de 2,5 TB em diretórios menores. Essa limitação será corrigida em uma versão mais recente da ferramenta.
Identificar os locais de destino no serviço Blob
Para cada diretório ou arquivo que será importado, você precisa identificar um diretório virtual de destino ou um blob no serviço Blob do Azure. Você usará esses destinos como entradas para a Ferramenta de Importação/Exportação do Azure. Observe que os diretórios devem ser delimitados com o caractere de barra "/".
A tabela a seguir mostra alguns exemplos de blobs de destino:
Arquivo ou diretório de origem | Blob de destino ou diretório virtual |
---|---|
H:\Video | https://mystorageaccount.blob.core.windows.net/video |
H:\Photo | https://mystorageaccount.blob.core.windows.net/photo |
K:\Temp\FavoriteVideo.ISO | https://mystorageaccount.blob.core.windows.net/favorite/FavoriteVideo.ISO |
\\myshare\john\music | https://mystorageaccount.blob.core.windows.net/music |
Determinar quantas unidades serão necessárias
Em seguida, será necessário determinar:
O número de discos rígidos necessários para armazenar os dados.
Os diretórios e/ou os arquivos independentes que serão copiados em cada disco rígido.
Verifique se você tem o número de discos rígidos necessários para armazenar os dados que você está transferindo.
Copiar dados para o disco rígido
Esta seção descreve como chamar a Ferramenta de Importação/Exportação do Azure para copiar seus dados em um ou mais discos rígidos. Sempre que você chama a Ferramenta de Importação/Exportação do Azure, uma nova sessão de cópia é criada. Crie pelo menos uma sessão de cópia para cada unidade na qual você copia dados; em alguns casos, talvez seja necessário mais de uma sessão de cópia para copiar todos os dados em uma única unidade. Veja alguns motivos pelos quais talvez você precise de várias sessões de cópia:
Você deve criar uma sessão de cópia separada para cada unidade na qual você copia.
Uma sessão de cópia pode copiar um único diretório ou um único blob na unidade. Se você estiver copiando vários diretórios, vários blobs ou uma combinação de ambos, será necessário criar várias sessões de cópia.
Você pode especificar propriedades e metadados que serão definidos nos blobs importados como parte de um trabalho de importação. As propriedades ou metadados que você especifica para uma sessão de cópia serão aplicados a todos os blobs especificados por essa sessão de cópia. Se você quiser especificar propriedades ou metadados diferentes para alguns blobs, será necessário criar uma sessão de cópia separada. Confira Configuração de propriedades e metadados durante o processo de importação para saber mais.
Observação
se você tiver vários computadores que atendam aos requisitos descritos em configurando a ferramenta de Importação/Exportação do Azure, poderá copiar dados para vários discos rígidos em paralelo executando uma instância dessa ferramenta em cada computador.
Para cada disco rígido que você prepara com a Ferramenta de Importação/Exportação do Azure, a ferramenta criará um único arquivo de diário. Você precisará dos arquivos de diário de todas as unidades para criar o trabalho de importação. O arquivo de diário também pode ser usado para retomar a preparação da unidade se a ferramenta for interrompida.
Sintaxe da Ferramenta de Importação/Exportação do Azure para um trabalho de importação
para preparar as unidades para um trabalho de importação, chame a ferramenta de Importação/Exportação do Azure com o comando prepimport da . Os parâmetros que você inclui dependem se esta for a primeira sessão de cópia ou uma sessão de cópia subsequente.
A primeira sessão de cópia para uma unidade exige alguns parâmetros adicionais para especificar a chave da conta de armazenamento; a letra da unidade de destino; se a unidade deve ser formatada; se a unidade deve ser criptografada e, em caso positivo, a chave do BitLocker; e o diretório do log. Veja a sintaxe de uma sessão de cópia inicial para copiar um diretório ou um único arquivo:
Primeira sessão de cópia para copiar um único diretório
WAImportExport PrepImport /sk:<StorageAccountKey> /csas:<ContainerSas> /t: <TargetDriveLetter> [/format] [/silentmode] [/encrypt] [/bk:<BitLockerKey>] [/logdir:<LogDirectory>] /j:<JournalFile> /id:<SessionId> /srcdir:<SourceDirectory> /dstdir:<DestinationBlobVirtualDirectory> [/Disposition:<Disposition>] [/BlobType:<BlockBlob|PageBlob>] [/PropertyFile:<PropertyFile>] [/MetadataFile:<MetadataFile>]
Primeira sessão de cópia para copiar um único arquivo
WAImportExport PrepImport /sk:<StorageAccountKey> /csas:<ContainerSas> /t: <TargetDriveLetter> [/format] [/silentmode] [/encrypt] [/bk:<BitLockerKey>] [/logdir:<LogDirectory>] /j:<JournalFile> /id:<SessionId> /srcfile:<SourceFile> /dstblob:<DestinationBlobPath> [/Disposition:<Disposition>] [/BlobType:<BlockBlob|PageBlob>] [/PropertyFile:<PropertyFile>] [/MetadataFile:<MetadataFile>]
Em sessões de cópia subsequentes, não é necessário especificar os parâmetros iniciais. Veja a sintaxe de uma sessão de cópia subsequente para copiar um diretório ou um único arquivo:
Sessões de cópia subsequentes para copiar um único diretório
WAImportExport PrepImport /j:<JournalFile> /id:<SessionId> /srcdir:<SourceDirectory> /dstdir:<DestinationBlobVirtualDirectory> [/Disposition:<Disposition>] [/BlobType:<BlockBlob|PageBlob>] [/PropertyFile:<PropertyFile>] [/MetadataFile:<MetadataFile>]
Sessões de cópia subsequentes para copiar um único arquivo
WAImportExport PrepImport /j:<JournalFile> /id:<SessionId> /srcfile:<SourceFile> /dstblob:<DestinationBlobPath> [/Disposition:<Disposition>] [/BlobType:<BlockBlob|PageBlob>] [/PropertyFile:<PropertyFile>] [/MetadataFile:<MetadataFile>]
Parâmetros para a primeira sessão de cópia de um disco rígido
Sempre que você executar a Ferramenta de Importação/Exportação do Azure para copiar arquivos no disco rígido, a ferramenta criará uma sessão de cópia. Cada sessão de cópia copia um único diretório ou um único arquivo em um disco rígido. O estado da sessão de cópia é gravado no arquivo de diário. Se uma sessão de cópia for interrompida (por exemplo, devido a uma perda de energia do sistema), ela poderá ser retomada executando a ferramenta novamente e especificando o arquivo de diário na linha de comando.
Aviso
Se você especificar o parâmetro /format para a primeira sessão de cópia, a unidade será formatada e todos os dados no disco serão apagados. Recomendamos o uso de unidades em branco apenas para a sessão de cópia.
O comando usado para a primeira sessão de cópia de cada unidade exige parâmetros diferentes dos comandos para sessões de cópia subsequentes. A tabela a seguir lista os parâmetros adicionais disponíveis para a primeira sessão de cópia:
Parâmetro de linha de comando | Descrição |
---|---|
/SK:< StorageAccountKey> |
Optional. A chave da conta de armazenamento na qual os dados serão importados. Você deve incluir /SK:< StorageAccountKey > ou /CSAs:< containers > no comando. |
/CSAs:< ContainerSas> |
Optional . O SAS do contêiner a ser usado para importar dados na conta de armazenamento. Você deve incluir /SK:< StorageAccountKey > ou /CSAs:< containers > no comando.O valor desse parâmetro deve começar com o nome do contêiner, seguido por um ponto de interrogação (?) e o token SAS. Por exemplo: mycontainer?sv=2014-02-14&sr=c&si=abcde&sig=LiqEmV%2Fs1LF4loC%2FJs9ZM91%2FkqfqHKhnz0JM6bqIqN0%3D&se=2014-11-20T23%3A54%3A14Z&sp=rwdl As permissões, especificadas na URL ou em uma política de acesso armazenada, devem incluir Leitura, Gravação e Exclusão para trabalhos de importação, e Leitura, Gravação e Lista para trabalhos de exportação. Quando este parâmetro for especificado, todos os blobs a serem importados ou exportados deverão estar dentro do contêiner especificado na assinatura de acesso compartilhado. |
/t:< TargetDriveLetter> |
Required. A letra da unidade do disco rígido de destino para a sessão de cópia atual, sem os dois-pontos no final. |
/Format |
Optional. Especifique esse parâmetro quando for necessário formatar a unidade; caso contrário, omita-o. Antes de a ferramenta formatar a unidade, ela solicitará uma confirmação no console. Para suprimir a confirmação, especifique o parâmetro /silentmode. |
/silentmode |
Optional. Especifique esse parâmetro para suprimir a confirmação para formatar a unidade de destino. |
/Encrypt |
Optional. Especifique esse parâmetro quando a unidade ainda não tiver sido criptografada com o BitLocker e precisar ser criptografada pela ferramenta. Se a unidade já tiver sido criptografada com o BitLocker, omita esse parâmetro e especifique o parâmetro /bk , fornecendo a chave do BitLocker existente.Se você especificar o parâmetro /format , também deverá especificar o parâmetro /encrypt . |
/BK:< BitLockerKey> |
Optional. Se /encrypt for especificado, omita este parâmetro. Se /encrypt for omitido, você já precisa ter criptografado a unidade com o BitLocker. Use esse parâmetro para especificar a chave do BitLocker. A criptografia do BitLocker é exigida em todos os discos rígidos para trabalhos de importação. |
/logdir:< Logdirectory> |
Optional. O diretório de log especifica um diretório a ser usado para armazenar logs detalhados, bem como arquivos de manifesto temporários. Se nenhum for especificado, o diretório atual será usado como o diretório de log. |
Parâmetros obrigatórios para todas as sessões de cópia
O arquivo de diário contém o status de todas as sessões de cópia de um disco rígido. Ele também contém as informações necessárias para criar o trabalho de importação. Você sempre deve especificar um arquivo de diário ao executar a Ferramenta de Importação/Exportação do Azure, bem como uma ID da sessão de cópia:
Parâmetro de linha de comando | Descrição |
/j:< JournalFile> |
Required. O caminho para o arquivo de diário. Cada unidade deve ter exatamente um arquivo de diário. Observe que o arquivo de diário não deve residir na unidade de destino. A extensão do arquivo de diário é .jrn . |
/id:< Sessionid> |
Required. A ID de sessão identifica uma sessão de cópia. Ela é usada para garantir a recuperação correta de uma sessão de cópia interrompida. Os arquivos copiados em uma sessão de cópia são armazenados em um diretório nomeado como a ID de sessão na unidade de destino. |
Parâmetros para copiar um único diretório
Ao copiar um único diretório, os seguintes parâmetros obrigatórios e opcionais serão aplicáveis:
Parâmetro de linha de comando | Descrição |
---|---|
/srcdir:< SourceDirectory> |
Required. O diretório de origem que contém os arquivos a serem copiados para a unidade de destino. O caminho do diretório deve ser um caminho absoluto (não um caminho relativo). |
/dstdir:< DestinationBlobVirtualDirectory> |
Required. O caminho até o diretório virtual de destino em sua conta de armazenamento do Microsoft Azure. O diretório virtual pode ou não existir.Você pode especificar um contêiner ou um prefixo de blob como music/70s/ . O diretório de destino deve começar com o nome do contêiner, seguido por uma barra "/" e, opcionalmente, pode incluir um diretório virtual de blob que termina com "/".Quando o contêiner de destino for o contêiner raiz, especifique explicitamente o contêiner raiz, incluindo a barra, como $root/ . Como os blobs no contêiner raiz não podem incluir "/" em seus nomes, quaisquer subdiretórios no diretório de origem não serão copiados quando o diretório de destino for o contêiner raiz.Certifique-se de usar nomes de contêineres válidos ao especificar diretórios virtuais ou blobs de destino. Tenha em mente que os nomes de contêiner devem estar em minúsculas. Para conhecer as regras de nomenclatura de contêineres, consulte Nomenclatura e referência de contêineres, blobs e metadados. |
/Disposition:< rename|no-overwrite|overwrite> |
Optional. Especifica o comportamento quando um blob com o endereço especificado já existe. Os valores válidos para este parâmetro são: rename , no-overwrite e overwrite . Observe que esses valores diferenciam maiúsculas de minúsculas. Se nenhum valor for especificado, o padrão será rename .O valor especificado para esse parâmetro afeta todos os arquivos no diretório especificado pelo parâmetro /srcdir . |
/BlobType:< BlockBlob| PageBlob> |
Optional. Especifica o tipo de blob para os blobs de destino. Os valores válidos são: BlockBlob e PageBlob . Observe que esses valores diferenciam maiúsculas de minúsculas. Se nenhum valor for especificado, o padrão será BlockBlob .Na maioria dos casos, BlockBlob é recomendado. Se você especificar PageBlob , o comprimento de cada arquivo no diretório deverá ser um múltiplo de 512, o tamanho de uma página para blobs de página. |
/PropertyFile:< PropertyFile> |
Optional. Caminho até o arquivo de propriedades para os blobs de destino. Confira Importação/Exportação formato de arquivo de propriedades e metadados do serviço para obter mais informações. |
/MetadataFile:< MetadataFile> |
Optional. Caminho até o arquivo de metadados para os blobs de destino. Confira Importação/Exportação formato de arquivo de propriedades e metadados do serviço para obter mais informações. |
Parâmetros para copiar um único arquivo
Ao copiar um único arquivo, os seguintes parâmetros obrigatórios e opcionais serão aplicáveis:
Parâmetro de linha de comando | Descrição |
---|---|
/srcfile:< Sourcefile> |
Required. O caminho completo até o arquivo a ser copiado. O caminho do diretório deve ser um caminho absoluto (não um caminho relativo). |
/dstblob:< DestinationBlobPath> |
Required. O caminho até o blob de destino em sua conta de armazenamento do Windows Azure. O blob pode ou não existir.Especifique o nome do blob, começando com o nome do contêiner. O nome do blob não pode começar com "/" ou com o nome da conta de armazenamento. Para conhecer as regras de nomenclatura de blobs, consulte Nomenclatura e referência de contêineres, blobs e metadados. Quando o contêiner de destino for o contêiner raiz, especifique explicitamente $root como o contêiner, por exemplo $root/sample.txt . Observe que os blobs no contêiner raiz não podem incluir "/" em seus nomes. |
/Disposition:< rename|no-overwrite|overwrite> |
Optional. Especifica o comportamento quando um blob com o endereço especificado já existe. Os valores válidos para este parâmetro são: rename , no-overwrite e overwrite . Observe que esses valores diferenciam maiúsculas de minúsculas. Se nenhum valor for especificado, o padrão será rename . |
/BlobType:< BlockBlob| PageBlob> |
Optional. Especifica o tipo de blob para os blobs de destino. Os valores válidos são: BlockBlob e PageBlob . Observe que esses valores diferenciam maiúsculas de minúsculas. Se nenhum valor for especificado, o padrão será BlockBlob .Na maioria dos casos, BlockBlob é recomendado. Se você especificar PageBlob , o comprimento de cada arquivo no diretório deverá ser um múltiplo de 512, o tamanho de uma página para blobs de página. |
/PropertyFile:< PropertyFile> |
Optional. Caminho até o arquivo de propriedades para os blobs de destino. Confira Importação/Exportação formato de arquivo de propriedades e metadados do serviço para obter mais informações. |
/MetadataFile:< MetadataFile> |
Optional. Caminho até o arquivo de metadados para os blobs de destino. Confira Importação/Exportação formato de arquivo de propriedades e metadados do serviço para obter mais informações. |
Retomando uma sessão de cópia interrompida
Se uma sessão de cópia for interrompida por qualquer motivo, você poderá retomá-la executando a ferramenta apenas com o arquivo de diário especificado:
WAImportExport.exe PrepImport /j:<JournalFile> /id:<SessionId> /ResumeSession
Somente a sessão de cópia mais recente, se for finalizada de maneira anormal, poderá ser retomada.
Importante
Ao retomar uma sessão de cópia, não modifique os diretórios e arquivos de dados de origem adicionando ou removendo arquivos.
Anulando uma sessão de cópia interrompida
Se uma sessão de cópia for interrompida e não for possível retomá-la (por exemplo, se um diretório de origem ficar inacessível), será necessário anular a sessão atual para que ela possa ser revertida e novas sessões de cópia possam ser iniciadas:
WAImportExport.exe PrepImport /j:<JournalFile> /id:<SessionId> /AbortSession
Somente a última sessão de cópia, se for finalizada de maneira anormal, poderá ser anulada. Observe que não é possível anular a primeira sessão de cópia de uma unidade. Em vez disso, reinicie a sessão de cópia com um novo arquivo de diário.
Próximas etapas
- Configurando a Ferramenta de Importação/Exportação do Azure
- Definindo propriedades e metadados durante o processo de importação
- Fluxo de trabalho de exemplo para preparar discos rígidos para um trabalho de importação
- Referência rápida para comandos usados com frequência
- Revisão do status do trabalho com arquivos de log de cópia
- Reparação de um trabalho de importação
- Reparação de um trabalho de exportação
- Solucionando problemas da Ferramenta de Importação/Exportação do Azure