Compartilhar via

Certificação do Conector do Data Factory

  • Artigo

Importante

O programa de certificação do conector está atualmente passando por alterações e o registro de novas certificações de conector está em espera no momento. Planejamos reativar esse processo de registro durante o primeiro trimestre do ano civil de 2025. Caso tenha um conector certificado que deseja atualizar, entre em contato com nossa equipe em dataconnectors@microsoft.com para obter instruções sobre como enviar uma nova versão.

Os proprietários de fonte de dados que desenvolvem um conector personalizado para sua fonte de dados podem querer distribuir seu conector personalizado de forma mais ampla para os usuários do Data Factory. Depois que um conector personalizado é criado, usado e validado pelos usuários finais, o proprietário da fonte de dados pode enviá-lo para a certificação da Microsoft.

A certificação de um conector do Data Factory disponibiliza o conector publicamente, pronto para uso, no Data Factory do Microsoft Fabric e no Microsoft Power BI nas seguintes experiências:

  • Dataflow Gen2 do Microsoft Fabric
  • Dataflow Gen1 do Microsoft Power BI
  • Datamart do Microsoft Power BI
  • Modelo semântico do Microsoft Power BI (no Serviço do Power BI)
  • Microsoft Power BI Desktop
  • Gateway de dados local para o Microsoft Fabric e o Microsoft Power BI

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 conector em si são direcionados para o desenvolvedor parceiro.

Observação

Hoje você pode aproveitar o SDK do Power Query para criar um conector que possa ser certificado por meio do programa de certificação do conector do Data Factory. Acesse a Visão geral do SDK do Power Query para saber mais sobre essa ferramenta.

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 de lançamento 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. Caso precise 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 dos serviços que eles oferecem. A Microsoft fornece a lista para sua comodidade e sem quaisquer garantias ou recomendações. Para saber mais, fale com seu contato de certificação da Microsoft.

  • O desenvolvedor deve fornecer uma estimativa para uso atual e futuro.

  • O conector já deve ser disponibilizado aos clientes diretamente para atender a uma necessidade do usuário ou cenário de negócios. Esses critérios podem ser atendidos usando um programa de versão prévia a que distribui o conector concluído diretamente para usuários finais e organizações. Sugerimos que os desenvolvedores de conectores usem um mecanismo de auto-distribuição e executem testes internos de seus próprios conectores para iterar sobre seus conectores em um grupo controlado. 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 de uso previsto pelos clientes.

  • Deve haver um thread no Fórum ideias do Fabric orientado pelos clientes para indicar a demanda para disponibilizar o conector publicamente no Data Factory e/ou no Power BI. 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 que passam por certificação tenham clientes e negócios significativos precisam ser usados e suportados após a certificação.

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.

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:

    • Usar o formato do documento da Seção.
    • Conter um cabeçalho/adorno de versão acima do documento da seção.
    • Ter metadados da documentação da função.
    • Ter o manipulador TestConnection.
    • Seguir as convenções de nomenclatura (por exemplo, DataSourceKind.FunctionName). Ele não deve incluir palavras como "Fabric", "Power BI", "Conector" ou "API".
    • Retornar dados em formato tabular, organizados em tabelas com colunas, como uma fonte de dados relacional. Não há compatibilidade com formatos multidimensionais baseados em cubos, dimensões e medidas.
    • Comporte-se da mesma forma no modo Import e DirectQuery, retornando resultados idênticos.
    • Ter o sinalizador Beta definido como True na versão inicial.

  • 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, 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).

Após a certificação

Depois que o conector for certificado e liberado pelas experiências do Microsoft Fabric e do Microsoft 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 nos ambientes anteriores à certificação (como o Power BI Desktop e o Gateway de Dados) 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.