Compartilhar via

Certificação do conector do Power Query

  • Artigo

Observação

Neste artigo, você verá uma descrição dos requisitos e do processo para enviar um conector do Power Query para certificação. Leia todo o texto com atenção antes de iniciar o processo de certificação.

Introdução

Com o SDK do Power Query, todos têm o poder de criar um conector personalizado do Power Query para se conectar a uma fonte de dados do Power Query. Atualmente, os conectores personalizados só são compatíveis com modelos semânticos do Power BI (Power BI Desktop e serviço do Power BI) e exigem o uso de um gateway de dados local para atualizar por meio do serviço do Power BI. Conectores personalizados precisam ser distribuídos individualmente pelo desenvolvedor.

Os proprietários da fonte de dados que desenvolvem um conector personalizado para a fonte de dados podem querer distribuir o conector personalizado de maneira mais ampla para usuários do Power Query. Depois que um conector personalizado for criado, usado e validado pelos usuários finais, o proprietário da fonte de dados poderá enviá-lo para certificação da Microsoft.

Certificar um conector personalizado do Power Query torna o conector disponível publicamente, pronto para uso, em modelos semânticos do Power BI (Power BI Desktop e serviço do Power BI), fluxos de dados do Power BI e datamarts do Power BI. Há suporte para conectores certificados em PowerBI.com e todas as versões do Power BI Premium.

Os conectores certificados são:

  • mantidos pelo desenvolvedor do parceiro;

  • têm suporte do desenvolvedor parceiro;

  • certificados pela Microsoft;

  • distribuídos pela Microsoft.

Trabalhamos com parceiros para tentar garantir que eles tenham suporte na manutenção, mas os problemas do cliente com o próprio conector serão direcionados para o desenvolvedor parceiro.

Diferenças entre conectores personalizados e certificados

Os conectores certificados são integrados e estão prontos para uso no Power BI Desktop; além disso, são implantados no Serviço do Power BI, fluxos de dados do Power BI e nos datamarts do Power BI. Conectores personalizados só são compatíveis com modelos semânticos do Power BI e precisam ser carregados no Power BI Desktop, conforme descrito em Carregar uma extensão no Power BI Desktop. Ambos os tipos de conectores podem ser atualizados no Power BI Desktop ou no Serviço do Power BI por meio de um gateway de dados local, com a implementação de TestConnection. O gateway de dados local é necessário para conectores personalizados.

Os conectores certificados no Power BI Desktop com uma implementação TestConnection também permitem atualização de ponta a ponta por meio da nuvem (Serviço do Power BI) sem a necessidade de um gateway de dados local. O ambiente serviço do Power BI hospeda essencialmente um "gateway de nuvem" que é executado de modo semelhante ao gateway local. Após a certificação, implantamos seu conector nesse ambiente para que ele esteja disponível para todos os clientes do Power BI.

Os conectores personalizados e certificados com componentes extras (por exemplo, driver ODBC) precisam que o componente extra seja instalado no computador do usuário final e exigem o gateway de dados local, a menos que o componente extra seja implantado na nuvem do Power BI. Atualmente, não estamos certificando e implantando novos componentes extras na nuvem do Power BI; portanto, a certificação de conectores com uma dependência em um componente extra não removerá o requisito do gateway de dados local.

Distribuição de conectores personalizados

Os conectores personalizados podem e devem ser distribuídos aos usuários finais antes da certificação.

Como M é uma linguagem versátil que, como visto na Manipulação da autenticação, tem a capacidade de interagir com credenciais armazenadas, precisamos dar aos usuários uma maneira de permitir apenas que conectores confiáveis sejam executados.

Na perspectiva de um desenvolvedor, é necessário autoassinar o conector personalizado e fornecer aos usuários as informações (impressão digital) para carregá-lo com segurança.

Na perspectiva de um usuário, é necessário usar a impressão digital do desenvolvedor para confiar com segurança e carregar o conector personalizado para uso. Como alternativa, os usuários podem optar por reduzir suas configurações de segurança para permitir que código não certificado pela Microsoft ou outro desenvolvedor seja carregado, mas esta opção não é recomendada.

Visão geral da certificação

Pré-requisitos

Para garantir a melhor experiência para nossos clientes, consideramos apenas os conectores que atendem a um conjunto de pré-requisitos para certificação:

  • O conector deve ser para um produto público.

  • O conector deve ser considerado concluído por código para uma versão inicial. O programa permite iterações e atualizações frequentes. A Microsoft não oferece assistência técnica ou consultoria de desenvolvimento de conector personalizado. Recomendamos usar recursos públicos, como nossa documentação do SDK e nosso repositório de amostras. Se você precisar de mais assistência, podemos compartilhar uma lista de consultores conhecidos de desenvolvimento de conectores personalizados de terceiros que você pode querer envolver diretamente, separados de qualquer programa ou parceria da Microsoft. A Microsoft não é afiliada a nenhum desses consultores e não é responsável pelo uso que você faz dos serviços deles. A Microsoft fornece a lista para sua comodidade e sem quaisquer garantias ou recomendações. Fale com seu contato de certificação da Microsoft para saber mais.

  • O desenvolvedor deve fornecer uma estimativa para uso. Sugerimos que os desenvolvedores de conectores para produtos muito sofisticados usem nossos recursos de autoassinatura do conector para fornecê-los diretamente ao cliente.

  • O conector já deve ser disponibilizado direto aos clientes para atender a um cenário de negócios ou de necessidade do usuário. Esses critérios podem ser atendidos usando um programa de versão prévia privada que distribui o conector concluído diretamente para usuários finais e organizações por meio da autoassinatura. Cada usuário ou organização deve ser capaz de fornecer comentários e validação de que há uma necessidade comercial para o conector e que o conector está funcionando para atender aos seus requisitos comerciais.

  • O conector deve estar funcionando com êxito em um nível antecipado de uso pelos clientes.

  • Deve haver uma conversa no fórum ideias do Power BI promovida pelos clientes para indicar a demanda para disponibilizar o conector publicamente no Power BI Desktop. Não há um limite definido de participação. No entanto, quanto mais participação, mais forte será a demanda evidenciada pelo conector.

Esses pré-requisitos existem para garantir que os conectores submetidos à certificação tenham clientes e negócios significativos que precisam ser usados e com suporte após a certificação.

Processos e linhas do tempo

Os conectores certificados são lançados com versões mensais do Power BI Desktop; portanto, os prazos para cada versão contam a partir de cada data de lançamento do Power BI Desktop. A duração esperada do processo de certificação, desde o registro até a liberação, varia dependendo da qualidade e da complexidade do envio do conector. A Microsoft não fornece nenhuma garantia de cronogramas específicos em relação a qualquer revisão e aprovação de conectores. Os prazos rígidos para cada revisão de conector são descritos nas etapas a seguir, mas a Microsoft não garante a adesão a esses cronogramas.

  • Registro: notificação da intenção de certificar seu conector personalizado. Esse registro deve ocorrer até o dia 15 do mês, dois meses antes do lançamento da versão pretendida do Power BI Desktop.

    • Por exemplo, para a versão de abril do Power BI Desktop, a data limite seria 15 de fevereiro.

  • Envio: envio dos arquivos do conector para análise da Microsoft. Esse envio deve ocorrer até o dia 1º do mês antes do lançamento pretendido do Power BI Desktop.

    • Por exemplo, para a versão de abril do Power BI Desktop, a data limite seria 1º de março.

  • Análise técnica: finalização dos arquivos do conector, aprovação na análise e certificação da Microsoft. Isso deve ocorrer até o dia 15 do mês, dois meses antes da versão pretendida do Power BI Desktop.

    • Por exemplo, para a versão de abril do Power BI Desktop, a data limite seria 15 de março.

Devido à complexidade das análises técnicas e possíveis atrasos, rearquitetura e problemas de teste, é altamente recomendável enviar antecipadamente com um longo tempo de execução para a versão inicial e a certificação. Se você acha que é importante disponibilizar o conector a alguns clientes com sobrecarga mínima, recomendamos a autoassinatura e o fornecimento dessa forma.

Requisitos de certificação

Temos um determinado conjunto de requisitos para certificação. Reconhecemos que nem todos os desenvolvedores podem atender a esses requisitos e esperamos introduzir um conjunto de recursos que lidará com as necessidades do desenvolvedor em breve.

Arquivos de envio (artefatos)

Verifique se os arquivos do conector que você envia incluem todos os seguintes:

  • Arquivo conector (.mez)

    • O arquivo .mez deve seguir padrões de estilo e ser nomeado de forma semelhante ao nome do produto ou serviço. Ele não deve incluir palavras como "Power BI", "Conector" ou "API".
    • Nomeie o arquivo .mez: ProductName.mez

  • Arquivo Power BI Desktop (.pbix) para teste

    • Precisamos de um relatório de exemplo do Power BI (.pbix) para testar o conector.
    • O relatório deve incluir pelo menos uma consulta para testar cada item em sua tabela de navegação.
    • Se não houver um esquema definido (por exemplo, bancos de dados), o relatório precisará incluir uma consulta para cada "tipo" de tabela que o conector pode manipular.

  • Conta de teste para sua fonte de dados

    • Nós usamos a conta de teste para testar e solucionar problemas do conector.
    • Forneça uma conta de teste persistente, para que possamos usar a mesma conta para certificar quaisquer atualizações futuras.

  • Instruções de teste

    • Forneça qualquer documentação sobre como usar o conector e testar sua funcionalidade.

  • Links para dependências externas (por exemplo, drivers ODBC)

Recursos e estilo

O conector deve seguir um conjunto de regras de recurso e estilo para atender a um padrão de usabilidade consistente com outros conectores certificados.

  • O conector DEVE:

  • O FunctionName deve fazer sentido para o domínio (por exemplo, "Conteúdo", "Tabelas", "Documento", "Bancos de Dados" e assim por diante).

  • O conector DEVE:

    • Ter ícones.
    • Ter uma tabela de navegação.
    • Colocar cadeias de caracteres em um arquivo resources.resx. URLs e valores devem ser codificados no código do conector e não serem colocados no arquivo resources.resx.

Segurança

Há considerações de segurança específicas que o conector deve tratar.

  • Se Extension.CurrentCredentials() for usado:

    • O uso é necessário? Nesse caso, para onde as credenciais são enviadas?
    • Há alguma garantia de que as solicitações foram feitas por HTTPS?
    • Se as credenciais forem enviadas usando Web.Contents() via GET:
      • Pode ser transformado em POST?
      • Se GET for necessário, o conector DEVERÁ usar o registro CredentialQueryString no registro de opções Web.Contents() para passar credenciais confidenciais.

  • Se as funções Diagnostics.* forem usadas:

    • Valide o que está sendo rastreado; os dados não devem conter PII nem grandes quantidades de dados desnecessários.
    • Se você implementou um rastreamento significativo no desenvolvimento, implemente uma variável ou sinalizador de recurso que determina se o rastreamento deve estar ativado. Esse rastreamento deve ser desativado antes do envio para certificação.

  • Se Expression.Evaluate() for usado:

    • Valide de onde a expressão está vindo e o que ela é (ou seja, se pode construir dinamicamente chamadas para Extension.CurrentCredentials() e assim por diante).
    • O Expression não deve ser fornecido pelo usuário nem receber entrada de usuário.
    • O Expression não deve ser dinâmico (ou seja, recuperado de uma chamada da Web).

Registrar-se para certificação

Se você tiver interesse em buscar a certificação do conector personalizado, verifique se seu cenário e conector atendem aos pré-requisitos e requisitos descritos neste artigo. Não fazer isso causará atrasos na certificação, pois nossa equipe exigirá que você corrija quaisquer problemas ou inconsistências antes de avançar.

Verifique se o conector está concluído e foi testado tanto na criação no Power BI Desktop quanto na atualização e no consumo no Serviço do Power BI. Verifique se você testou a atualização completa de ponta a ponta no Serviço do Power BI por meio do uso de um gateway de dados local.

Para começar, preencha nosso formulário de registro e uma pessoa da Microsoft entrará em contato para iniciar o processo.

Após a certificação

Depois que o conector for certificado e liberado por meio do Power BI Desktop e do serviço do Power BI, você precisará tomar algumas providências para ter certeza de poder usar corretamente o conector certificado disponível publicamente implantado na produção.

  • Você e os usuários finais devem usar a versão do conector certificado incluída no Power BI Desktop e o gateway de dados local, e remover todos os arquivos .mez ou .pqx (conectores personalizados) existentes usados antes da certificação. Se isso não for feito, o conector personalizado de teste poderá ser usado pelo Power Query inadvertidamente em vez do conector recém-certificado.
  • Os conectores personalizados só devem ser usados para testar novas versões do conector.
  • Ao trabalhar com usuários finais e clientes, certifique-se de que eles entendam que a versão do conector personalizado usada nos testes antes da certificação deve ser removida depois da conclusão do teste e da nova versão do conector certificado estar disponível.

Depois de desenvolver um conector para uma fonte de dados, considere ajudar os clientes a começar a trabalhar rapidamente criando um aplicativo de modelo. Um aplicativo de modelo fornece aos clientes um relatório predefinido conectado aos dados que eles podem usar, prontos para uso ou personalizáveis conforme necessário.

Observação

Os aplicativos de modelo não aceitam conectores que exigem um gateway.