Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Importante
O Cache do Azure para Redis anunciou a linha do tempo de desativação para todos os SKUs. Recomendamos migrar suas instâncias do Cache do Azure para Redis para o Redis Gerenciado pelo Azure assim que possível.
Para obter mais detalhes sobre a aposentadoria:
A funcionalidade de importação e exportação do Azure Cache para Redis permite importar ou exportar dados das instâncias do Azure Cache para Redis como instantâneos do Banco de Dados Redis (RDB). Os instantâneos são importados ou exportados usando um blob em uma conta de Armazenamento do Azure.
Você pode usar a funcionalidade de importação e exportação do Azure Redis para gerenciamento de dados, para migrar entre diferentes instâncias de cache ou para preencher um cache com dados antes do uso. Este artigo descreve como importar e exportar dados no Azure Redis e responde a perguntas frequentes.
Escopo de disponibilidade
| Camada | Básico, Standard | Premium | Enterprise, Enterprise Flash |
|---|---|---|---|
| Disponível | Não | Sim | Sim |
Há suporte para importação e exportação nas camadas Premium, Enterprise e Enterprise Flash.
Compatibilidade
Importação
- Você pode importar seus instantâneos RDB de blob de páginas ou blob de blocos.
- Você pode importar arquivos RDB de caches de camada Premium para caches da camada Enterprise e Enterprise Flash.
- Você não pode importar de caches da camada Redis Enterprise e Enterprise Flash para caches da camada Premium.
Exportação
- Você pode exportar seus instantâneos como blob de páginas RDB na camada Premium ou como blob de blocos
.gzem camadas Enterprise. - Contas de armazenamento de blobs não dão suporte à exportação.
Versões
- Os caches redis 4.0 dão suporte ao RDB versão 8 e inferior. Os caches redis 6.0 dão suporte ao RDB versão 9 e inferior.
- Você não pode importar backups exportados de versões mais recentes do Redis, como o Redis 6.0, para versões mais antigas, como o Redis 4.0.
Pré-requisitos
- Um cache de nível Premium, Enterprise ou Enterprise Flash no Cache do Azure para Redis.
- Para importar arquivos, um arquivo RDB ou arquivos carregados em blob de páginas ou blob de blocos no Armazenamento do Microsoft Azure, na mesma região e assinatura que o Cache do Azure para Redis.
Observação
Se você usar a identidade gerenciada para autenticação de conta de armazenamento, a conta de armazenamento poderá estar em uma assinatura diferente.
Importar
Você pode usar a importação para trazer arquivos RDB compatíveis com Redis de qualquer servidor Redis em execução em qualquer nuvem ou ambiente, incluindo Linux, Windows ou outros provedores de nuvem, como o Amazon Web Services. Importar os dados é uma forma fácil de criar um cache com os dados previamente populados.
Durante o processo de importação, o Azure Redis carrega os arquivos RDB do Armazenamento do Azure na memória e insere as chaves no cache.
Importante
A importação de dados exclui dados de cache pré-existentes e o cache não é acessível por clientes de cache durante o processo de importação.
Importante
Não há suporte para a importação das camadas Redis Enterprise para a camada Premium.
Observação
Antes de importar, assegure-se de que seu arquivo ou arquivos RDB estejam carregados em blobs de página ou blocos no Armazenamento do Azure. Se você seguir o procedimento exportar primeiro, seu arquivo RDB já está armazenado em um blob de páginas e está pronto para importação.
Para importar um ou mais blobs de cache, na página de cache do Redis no portal do Azure, selecione Importar dados em Administração no menu de navegação à esquerda.
Na página Importar dados, selecione um Método de Autenticação e, em seguida, selecione Escolher Blob(s).
Na página Contas de Armazenamento , selecione a conta de armazenamento que contém os dados a serem importados.
Na página Contêineres , selecione o contêiner na conta de armazenamento que contém os dados a serem importados.
Na página do contêiner, selecione as caixas de seleção ao lado de um ou mais blobs a serem importados e selecione Selecionar.
Na página Importar dados , selecione Importar para iniciar o processo de importação.
Você pode monitorar o progresso da importação seguindo as notificações do portal do Azure ou exibindo eventos no log de atividades.
Exportação
O processo de exportação exporta os dados armazenados no cache Redis do Azure para arquivos RDB. Você pode usar esse recurso para mover dados de um cache ou servidor redis do Azure para outro.
Durante o processo de exportação, um arquivo temporário é criado na máquina virtual que hospeda a instância do servidor Redis do Azure. Em seguida, o arquivo é carregado na conta de armazenamento escolhida. Quando a operação de exportação for concluída com êxito ou falha, o arquivo temporário será excluído.
Importante
- O Azure Redis não dá suporte à exportação para contas de armazenamento do Azure Data Lake Storage Gen2.
- As contas de armazenamento de blobs não dão suporte à exportação do Azure Redis.
- O Enterprise e o Enterprise Flash não dão suporte à importação ou exportação de ou para contas de armazenamento que usam firewalls ou pontos de extremidade privados. A conta de armazenamento precisa ter acesso à rede pública.
Se sua exportação para uma conta de armazenamento habilitada para firewall falhar, confira E se eu tiver o firewall habilitado na minha conta de armazenamento? Para obter mais informações, consulte a visão geral da conta de armazenamento do Azure.
Para exportar o conteúdo atual do cache para o armazenamento, na página do cache Redis no portal do Azure, selecione Exportar dados em Administração no menu de navegação à esquerda.
Na página Exportar dados, para prefixo de nome de BLOB, insira um prefixo para os nomes dos arquivos gerados por essa operação de exportação. Selecione um Método de Autenticação e, em seguida, selecione Escolher Contêiner de Armazenamento.
Na página Contas de Armazenamento , selecione a conta de armazenamento que contém os dados a serem exportados.
Na página Contêineres, se você quiser criar um novo contêiner para a exportação, selecione Contêiner e, na página Novo Contêiner, insira um nome para o contêiner e selecione Criar. Caso contrário, selecione o contêiner existente que você deseja usar.
Na página Contêineres , selecione o contêiner que você deseja usar para a exportação e selecione Selecionar.
Na página Exportar dados , selecione Exportar.
Você pode monitorar o progresso da operação de exportação seguindo as notificações do portal do Azure ou exibindo os eventos no log de atividades. Os caches permanecem disponíveis para uso durante o processo de exportação.
Perguntas frequentes sobre importação e exportação
Esta seção contém perguntas frequentes sobre os recursos de importação e exportação.
- Posso automatizar a importação-exportação usando o Azure PowerShell ou a CLI do Azure?
- Posso importar dados de qualquer servidor Redis?
- Posso importar ou exportar dados de uma conta de armazenamento em uma assinatura diferente do meu cache?
- Posso usar importação-exportação com clustering do Redis?
- Como a importação-exportação funciona com configurações de banco de dados personalizadas?
- Como a importação-exportação é diferente da persistência de dados do Redis?
- Meu cache está disponível durante uma operação de importação e exportação?
- E se eu tiver um firewall habilitado na minha conta de armazenamento?
- Quais versões do RDB posso importar?
- Quais camadas do Azure Redis dão suporte à importação-exportação?
- Quais permissões o token SAS (assinatura de acesso compartilhado) de contêiner de conta de armazenamento precisa para permitir a exportação?
- Por que recebi um erro ao exportar meus dados para o Armazenamento de Blobs do Azure?
Quais camadas dão suporte à importação-exportação?
Os recursos de importação e exportação estão disponíveis apenas nas camadas Premium, Enterprise e Enterprise Flash.
Posso importar dados de qualquer servidor Redis?
Sim, você pode importar dados que foram exportados de instâncias do Azure Redis. Você pode importar arquivos RDB de qualquer servidor Redis em execução em qualquer nuvem ou ambiente, incluindo Linux, Windows ou outros provedores de nuvem, como o Amazon Web Services.
Para importar esses dados, carregue o arquivo RDB do servidor Redis em uma página ou blob de blocos em uma conta de Armazenamento do Azure. Em seguida, importe-o para a instância de cache do Azure Redis.
Por exemplo, talvez você queira exportar os dados do cache de produção e importá-los para um cache que faz parte de um ambiente de preparo para teste ou migração.
Importante
Para importar com sucesso dados de blob de páginas exportados de servidores Redis que não sejam do Azure, o tamanho do blob de páginas deve ser alinhado em um limite de 512 bytes. Para obter o código de amostra para executar qualquer preenchimento de bytes necessários, veja Exemplo de upload de blob de páginas.
Quais versões do RDB posso importar?
Para obter mais informações sobre versões de RDB com suporte para importação, consulte Compatibilidade.
Meu cache está disponível durante uma operação de importação e exportação?
- Os caches permanecem disponíveis durante a exportação e você pode continuar a usar o cache durante uma operação de exportação.
- Os caches ficam indisponíveis quando uma operação de importação é iniciada e ficam disponíveis novamente quando a operação de importação é concluída.
Posso usar importação-exportação com clustering do Redis?
Sim, e você pode importar e exportar entre um cache clusterizado e um cache não clusterizado. Já que o cluster Redis só dá suporte a banco de dados 0, quaisquer dados em bancos de dados diferentes de 0 não serão importados. Quando os dados do cache clusterizados são importados, as chaves são redistribuídas entre os fragmentos do cluster.
Como a importação-exportação funciona com configurações de banco de dados personalizadas?
Alguns tipos de preços têm limites de banco de dados diferentes. Se você configurou um valor personalizado para a configuração do databases durante a criação do cache, há algumas considerações ao importar.
Quando você importa para uma camada de preços com limite menor databases do que a camada da qual você exportou:
- Se você usar o número padrão de
databases, que é 16 para todos os tipos de preço, nenhum dado será perdido. - Se você usar um número personalizado que esteja dentro dos
databaseslimites da camada para a qual você está importando, nenhum dado será perdido. - Se os dados exportados forem de um banco de dados que exceda os limites da nova camada, os dados dos bancos de dados em excesso não serão importados.
Como a importação-exportação é diferente da persistência de dados do Redis?
O recurso de persistência de dados do Cache do Azure para Redis é principalmente para durabilidade de dados, enquanto a funcionalidade de importação-exportação foi projetada para fazer backups de dados periódicos para PITR (recuperação pontual).
Ao configurar a persistência de dados, o cache mantém um instantâneo dos dados no disco, com base em uma frequência de backup configurável. Os dados são gravados com um formato binário proprietário do Redis.
Na camada Premium, o arquivo de persistência de dados é armazenado no Armazenamento do Azure, mas você não pode importar o arquivo para um cache diferente. Nas camadas Enterprise, o arquivo de persistência de dados é armazenado em um disco montado que não é acessível ao usuário.
Se um evento catastrófico desabilitar os caches primário e de réplica, os dados de cache persistentes serão restaurados automaticamente usando o instantâneo mais recente. A persistência de dados foi projetada para recuperação de desastre e não se destina a um mecanismo PITR.
Para fazer backups de dados periódicos para PITR, use a funcionalidade de importação e exportação. Para obter mais informações, veja Como configurar a persistência de dados para Cache do Azure para Redis.
Posso automatizar a importação-exportação usando o Azure PowerShell ou a CLI do Azure?
Sim. Para a camada Premium, consulte o seguinte conteúdo:
- Importar um cache Redis premium do Azure usando o Azure PowerShell
- Exportar um cache Redis premium do Azure usando o Azure PowerShell
- Importar um cache Redis premium do Azure usando a CLI do Azure
- Exportar um cache Redis premium do Azure usando a CLI do Azure
Para as camadas Enterprise e Enterprise Flash, consulte o seguinte conteúdo:
- Importar um cache Redis do Azure Enterprise usando o Azure PowerShell
- Exportar um cache Redis do Azure Enterprise usando o Azure PowerShell
- Importar um cache Redis do Azure Enterprise usando a CLI do Azure
- Exportar um cache Redis do Azure Enterprise usando a CLI do Azure
Por que recebi um erro ao exportar meus dados para o Armazenamento de Blobs do Azure?
A exportação funciona somente com arquivos RDB armazenados como blobs de páginas. Não há suporte para outros tipos de blob, incluindo contas de armazenamento de blobs com camadas quentes e frias. Para saber mais, confira Visão geral da conta de armazenamento do Azure.
Se você usar uma chave de acesso para autenticar uma conta de armazenamento, ter exceções de firewall na conta de armazenamento poderá fazer com que os processos de importação e exportação falhem.
O que devo fazer se o firewall estiver habilitado na minha conta de armazenamento?
Para uma instância de camada Premium, você deve selecionar Permitir que os serviços do Azure na lista de serviços confiáveis acessem essa conta de armazenamento nas configurações da conta de armazenamento. Em seguida, use a identidade gerenciada atribuída pelo sistema ou atribuída pelo usuário e provisione a função RBAC (controle de acesso baseado em função) do Colaborador de Dados de Blob de Armazenamento para essa ID de objeto. Para obter mais informações, consulte Identidade gerenciada para contas de armazenamento.
As instâncias Enterprise e Enterprise Flash não dão suporte à importação ou exportação de ou para contas de armazenamento que usam firewalls ou pontos de extremidade privados. A conta de armazenamento precisa ter acesso à rede pública.
Posso importar ou exportar dados de uma conta de armazenamento em uma assinatura diferente do meu cache?
Na camada Premium, você pode importar e exportar dados de uma conta de armazenamento em uma assinatura diferente do cache se usar a identidade gerenciada como o método de autenticação. Você precisa selecionar a assinatura que contém a conta de armazenamento ao configurar a importação ou exportação.
Quais permissões precisam ser concedidas ao token de assinatura de acesso compartilhado (SAS) do contêiner da conta de armazenamento para permitir a exportação?
Para que a exportação para uma conta de Armazenamento do Azure funcione com êxito, o token SAS (assinatura de acesso compartilhado) deve ter as seguintes permissões:
readaddcreatewritedeletetagmove