Atualizar um aplicativo para usar a biblioteca de cliente de banco de dados elástico mais recente

Aplica-se a:Banco de Dados SQL do Azure

Novas versões da biblioteca de cliente de Banco de Dados Elástico estão disponíveis por meio do NuGet e da interface do Gerenciador de Pacotes NuGet no Visual Studio. Atualizações contêm correções de bugs e suporte para novos recursos de biblioteca de cliente.

Para obter a versão mais recente: acesse Microsoft.Azure.SqlDatabase.ElasticScale.Client.

Recrie o aplicativo com a nova biblioteca e altere os metadados existentes do Gerenciador de Mapa de Fragmentos armazenados nos bancos de dados no Banco de Dados SQL do Azure para dar suporte a novos recursos.

Executar estas etapas nesta ordem garante que as versões antigas da biblioteca de cliente não estejam mais presentes em seu ambiente quando objetos de metadados são atualizados, o que significa que os objetos de metadados da versão antiga não serão criados após a atualização.

Etapas de atualização

1. Atualize seus aplicativos. No Visual Studio, baixe e referencie a versão mais recente da biblioteca do cliente em todos os seus projetos de desenvolvimento que usam a biblioteca. Em seguida, recrie e implante.

• Em sua solução do Visual Studio, selecione Ferramentas -->Gerenciador de pacotes do NuGet -->Gerenciar pacotes NuGet para solução.
• (Visual Studio 2013) No painel esquerdo, escolha Atualizações e selecione o botão Atualizar no pacote Biblioteca de cliente de escala elástica do Banco de dados SQL do Azure que aparece na janela.
• (Visual Studio 2015) Defina a caixa de Filtro para Atualização disponível. Selecione o pacote para atualizar e selecione o botão Atualizar .
• (2017 do visual Studio) Na parte superior da caixa de diálogo, selecione Atualizações. Selecione o pacote para atualizar e selecione o botão Atualizar .
• Criar e implantar.

2. Atualize seus scripts. Se você estiver usando scripts do PowerShell para gerenciar os fragmentos, baixe a nova versão da biblioteca e copie-a para o diretório de onde você executa scripts.

3. Atualize o seu serviço de mesclagem de divisão. Se você usar o serviço de mesclagem de divisão de banco de dados elástico para reorganizar dados fragmentados, baixe e implante a versão mais recente do serviço. Etapas detalhadas de atualização para o serviço podem ser encontradas aqui.

4. Atualize seus bancos de dados do Gerenciador do Mapa de Fragmentos. Atualizar os metadados que suportam seus mapas de fragmento no banco de dados SQL do Azure. Há duas maneiras que você pode fazer isso, usando o PowerShell ou C#. Ambas as opções são mostradas abaixo.

Opção 1: Atualizar os metadados usando o PowerShell

1. Baixar o utilitário de linha de comando mais recente para NuGet aqui e salvar em uma pasta.
2. Abra um Prompt de Comando, navegue para a mesma pasta e execute o comando: nuget install Microsoft.Azure.SqlDatabase.ElasticScale.Client
3. Navegue até a subpasta que contém a nova versão DLL do cliente que você baixou, por exemplo: cd .\Microsoft.Azure.SqlDatabase.ElasticScale.Client.1.0.0\lib\net45
4. Baixe o script da atualização de clientes de banco de dados elástico do Script Center e salve-o na mesma pasta que contém a DLL.
5. Nessa pasta, execute PowerShell .\upgrade.ps1 no prompt de comando e siga os prompts.

Opção 2: Atualizar os metadados usando C#

Como alternativa, crie um aplicativo do Visual Studio que abre sua ShardMapManager, itera em todos os fragmentos e executa a atualização de metadados chamando os métodos UpgradeLocalStore e UpgradeGlobalStore como neste exemplo:

    ShardMapManager smm =
       ShardMapManagerFactory.GetSqlShardMapManager
       (connStr, ShardMapManagerLoadPolicy.Lazy);
    smm.UpgradeGlobalStore();

    foreach (ShardLocation loc in
     smm.GetDistinctShardLocations())
    {
       smm.UpgradeLocalStore(loc);
    }

Essas técnicas para atualizações de metadados podem ser aplicadas várias vezes sem danos. Por exemplo, se uma versão mais antiga do cliente cria inadvertidamente um fragmento depois que você atualizou, você pode executar a atualização novamente entre todos os fragmentos para garantir que a versão mais recente de metadados está presente em toda a infraestrutura.

Observação: Novas versões da biblioteca de cliente atualizadas continuam a funcionar com as versões anteriores dos metadados do Gerenciador de Mapa de Fragmentos no Banco de Dados SQL do Azure e vice-versa. No entanto, para aproveitar alguns dos novos recursos mais recente do cliente, os metadados precisam ser atualizados. Atualizações de metadados não afetarão nenhum dados do usuário ou dados específicos do aplicativo, somente os objetos criados e usados pelo Gerenciador de mapa de fragmentos. E os aplicativos continuam a operar na sequência de atualização descrita acima.

O histórico de versões de cliente do banco de dados elástico

Para ver o histórico de versão, vá para Microsoft.Azure.SqlDatabase.ElasticScale.Client

Recursos adicionais

Ainda não está usando ferramentas de banco de dados elástico? Confira nosso Guia de Introdução. Em caso de dúvidas, entre em contato conosco na página de perguntas do Microsoft Q&A para Banco de Dados SQL e, para solicitações de recursos, adicione novas ideias ou vote em ideias existentes no Fórum de comentários sobre o Banco de Dados SQL.