TripPin parte 9 – TestConnection

Este tutorial de várias partes aborda a criação de uma nova extensão de fonte de dados para o Power Query. O tutorial deve ser feito sequencialmente — cada lição se baseia no conector criado nas lições anteriores, adicionando progressivamente novos recursos ao conector.

Nesta lição, você:

O suporte ao conector personalizado foi adicionado à versão de abril de 2018 do gateway de dados local pessoal. Essa nova funcionalidade (versão prévia) permite a Atualização Agendada de relatórios que fazem uso do conector personalizado.

Este tutorial aborda o processo de habilitação do conector para atualização e fornece um passo a passo rápido das etapas para configurar o gateway. Especificamente você:

1. Adicione um manipulador TestConnection ao conector.
2. Instale o Gateway de Dados local no modo Pessoal.
3. Habilite o suporte ao Conector Personalizado no Gateway.
4. Publique uma pasta de trabalho que utiliza seu conector no PowerBI.com.
5. Configure a atualização agendada para testar o conector.

Acesse Suporte de gateway de manipulação para obter mais informações sobre o manipulador TestConnection.

Contexto

Há três pré-requisitos para configurar uma fonte de dados para atualização agendada usando PowerBI.com:

• Há suporte para a fonte de dados: O ambiente de gateway de destino está ciente de todas as funções contidas na consulta que você deseja atualizar.
• As credenciais são fornecidas: Para apresentar a caixa de diálogo de entrada de credencial correta, o Power BI precisa saber o mecanismo de autenticação de suporte para uma determinada fonte de dados.
• As credenciais são válidas: Depois que o usuário fornece credenciais, elas são validadas chamando o manipulador da fonte de TestConnection dados.

Os dois primeiros itens são manipulados registrando seu conector com o gateway. Quando o usuário tenta configurar a atualização agendada no Power BI.com, as informações de consulta são enviadas ao seu gateway pessoal para determinar se há fontes de dados no serviço do Power BI que não são reconhecidas, ou seja, fontes personalizadas que você criou, e se estão disponíveis lá. O terceiro item é tratado invocando o manipulador TestConnection definido para sua fonte de dados.

Adicionando um manipulador TestConnection

O manipulador TestConnection é adicionado ao registro de declaração do Tipo de Fonte de Dados (o mesmo local em que você declara seus tipos de autenticação com suporte). O manipulador é um function com um único parâmetro do tipo any, que retorna um list. O primeiro valor na lista é a função que é chamada para realmente testar a conexão. Essa função geralmente é a mesma da função de fonte de dados principal. Em alguns casos, talvez seja necessário expor uma função separada shared para fornecer um teste de conexão eficiente, no entanto, isso geralmente deve ser evitado.

Como a função de fonte de dados TripPin não tem argumentos necessários, a implementação para TestConnection é bastante simples:

// Data Source Kind description
TripPin = [
    // TestConnection is required to enable the connector through the Gateway
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin Part 9 - TestConnection"
];

Habilitar conectores personalizados no gateway pessoal

Baixe e instale o gateway de dados local. Ao executar o instalador, selecione o modo pessoal.

Após a conclusão da instalação, inicie o gateway e entre no Power BI. O processo de login registra automaticamente seu gateway com o serviço do Power BI. Depois de conectado, execute as seguintes etapas:

1. Selecione a guia Conectores .

2. Selecione a opção para habilitar o suporte para conectores de dados personalizados.

3. Selecione o diretório do qual você deseja carregar conectores personalizados. Essa seleção geralmente é o mesmo diretório que você usa para o Power BI Desktop, mas o valor é configurável.

4. A página agora deve listar todos os arquivos de extensão no diretório de destino.

   

Acesse a documentação online para obter mais informações sobre o gateway.

Testar a atualização agendada

Abra o Power BI Desktop e crie um relatório que importe dados usando o conector TripPin.

Adicione um ou mais visuais à página do relatório (opcional) e, em seguida, publique o relatório para PowerBI.com.

Após a publicação, acesse PowerBI.com e localize o modelo semântico do relatório publicado. Selecione os três pontos e depois Agendar Atualização. Expanda as seções Conexão do Gateway e Credenciais da Fonte de Dados.

Selecione o link Editar credenciais para abrir a caixa de diálogo de autenticação e, em seguida, selecione entrar.

Após uma chamada bem-sucedida para TestConnection, as credenciais são aceitas. Agora você pode agendar a atualização ou selecionar a elipse do modelo semântico e, em seguida, selecionar Atualizar Agora. Você pode selecionar o link Atualizar histórico para exibir o status da atualização (o que geralmente leva alguns minutos para ser iniciado).

Conclusion

Parabéns! Agora você tem um conector personalizado pronto para produção que dá suporte à atualização automatizada por meio do serviço do Power BI.

Próximas etapas

TripPin Parte 10 – Query Folding