Atualizar com Aplicativos Lógicos
Usando os Aplicativos Lógicos e as chamadas REST, você pode executar operações automatizadas de atualização de dados nos seus modelos de tabela do Azure Analysis, incluindo sincronização de réplicas somente leitura para expansão da consulta.
Para saber mais sobre como usar as APIs REST com o Azure Analysis Services, confira Atualização assíncrona com a API REST.
Autenticação
Todas as chamadas precisam ser autenticadas com um token válido do Microsoft Entra ID (OAuth 2). O exemplo deste artigo usará uma SPN (entidade de serviço) para autenticação no Azure Analysis Services. Para saber mais, confira Criar uma entidade de serviço usando o portal do Azure.
Criar o aplicativo lógico
Importante
Os exemplos a seguir pressupõem que o firewall do Azure Analysis Services esteja desabilitado. Se o firewall estiver habilitado, o endereço IP público do iniciador da solicitação precisará ser adicionado à lista aprovada no firewall do Azure Analysis Services. Para saber mais sobre os intervalos de IP dos Aplicativos Lógicos do Azure por região, confira Limites e informações de configuração dos Aplicativos Lógicos do Azure.
Pré-requisitos
Criar uma entidade de serviço (SPN)
Para saber como criar uma entidade de serviço, consulte Criar uma entidade de serviço usando o portal do Azure.
Configurar permissões no Azure Analysis Services
A entidade de serviço que você criar deve ter permissões de administrador do servidor no servidor. Para saber mais, consulte Adicionar uma entidade de serviço à função de administrador do servidor.
Configurar o Aplicativo Lógico
Neste exemplo, o Aplicativo Lógico foi projetado para ser disparado quando uma solicitação HTTP for recebida. Isso permitirá o uso de uma ferramenta de orquestração, como o Azure Data Factory, para disparar a atualização do modelo do Azure Analysis Services.
Depois de criar um Aplicativo Lógico:
No designer de Aplicativo Lógico, escolha a primeira ação como Quando uma solicitação HTTP for recebida.
Essa etapa será preenchida com a URL HTTP POST quando o Aplicativo Lógico for salvo.
Adicione uma nova etapa e pesquise HTTP.
Selecione HTTP para adicionar essa ação.
Configure a atividade HTTP da seguinte maneira:
| Propriedade | Valor |
|---|---|
| Método | POST |
| URI | https://região do servidor/servers/nome do servidor do aas/models/nome do banco de dados/refreshes Por exemplo: https://westus.asazure.windows.net/servers/myserver/models/AdventureWorks/refreshes |
| Cabeçalhos | Content-Type, application/json  |
| Corpo | Para saber mais sobre como formar o corpo da solicitação, confira Atualização assíncrona com a API REST – POST /refreshes. |
| Autenticação | OAuth do Active Directory |
| Locatário | Preencha sua TenantId do Microsoft Entra |
| Público-alvo | https://*.asazure.windows.net |
| ID do Cliente | Insira a ClientID do nome da entidade de serviço |
| Tipo de Credencial | Segredo |
| Segredo | Insira o segredo do nome da entidade de serviço |
Exemplo:
Agora, teste o Aplicativo Lógico. No designer de Aplicativo Lógico, clique em Executar.
Consumir o Aplicativo Lógico com o Azure Data Factory
Depois que o Aplicativo Lógico for salvo, examine a atividade Quando uma solicitação HTTP for recebida e copie a URL HTTP POST que será gerada agora. Essa é a URL que pode ser usada pelo Azure Data Factory para fazer a chamada assíncrona para disparar o Aplicativo Lógico.
Veja um exemplo de atividade da Web do Azure Data Factory que executa essa ação.
Usar um Aplicativo Lógico autossuficiente
Caso não pretenda usar uma ferramenta de orquestração como o Data Factory para disparar a atualização do modelo, defina o aplicativo lógico para disparar a atualização de acordo com um agendamento.
Usando o exemplo acima, exclua a primeira atividade e substitua-a por uma atividade de Agendamento.
Este exemplo usará a Recorrência.
Depois que a atividade for adicionada, configure o Intervalo e a Frequência, adicione um novo parâmetro e escolha Nestes horários.
Selecione os horários desejados.
Salve o Aplicativo Lógico.