Partilhar via

Certificação Data Factory Connector

  • Artigo

Importante

O programa de certificação de conectores está atualmente passando por mudanças e o registro para novas certificações de conectores está atualmente suspenso. Este artigo será atualizado assim que o programa de certificação de conectores for aberto novamente para novos parceiros. Se você tem 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. As submissões são processadas todos os meses e a data limite para submissões é a primeira terça-feira de cada mês.

Os proprietários de fontes 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 certificação Microsoft.

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

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

Os conectores certificados são:

  • Mantido pelo desenvolvedor parceiro

  • Suportado pelo desenvolvedor parceiro

  • Certificado pela Microsoft

  • Distribuído 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 ao desenvolvedor parceiro.

Nota

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

Visão Geral da Certificação

Pré-requisitos

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

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

  • O conector deve ser considerado code-complete 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 conectores personalizados. Recomendamos o uso de recursos públicos, como nossa documentação do SDK e repositório de exemplos. Se você precisar de mais assistência, podemos compartilhar uma lista de consultores conhecidos de desenvolvimento de conectores personalizados do setor de 3ª parte que você pode querer contratar 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 deles. A Microsoft fornece a lista para sua conveniência e sem quaisquer garantias, recomendações ou garantias. Para saber mais, entre em contato com seu contato de certificação da Microsoft.

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

  • O conector já deve estar disponível 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 visualização, distribuindo 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 sob um grupo controlado. Cada usuário ou organização deve ser capaz de fornecer feedback e validação de que há uma necessidade comercial para o conector e que o conector está funcionando com êxito para atender aos seus requisitos de negócios.

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

  • Deve haver um thread no fórum Fabric Ideas orientado pelos clientes para indicar a demanda para tornar o conector disponível publicamente no Data Factory e/ou Power BI. Não há um limite definido de engajamento. No entanto, quanto mais engajamento, mais forte será a demanda evidenciada pelo conector.

Esses pré-requisitos existem para garantir que os conectores submetidos à certificação tenham necessidades significativas de clientes e negócios para serem usados e suportados após a certificação.

Requisitos de certificação

Temos um certo conjunto de requisitos para a certificação. Reconhecemos que nem todos os desenvolvedores podem atender a esses requisitos, e esperamos introduzir um conjunto de recursos que atenda às necessidades dos desenvolvedores em pouco tempo.

Características 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:

    • Use o formato de documento da seção.
    • Conter um cabeçalho/adorno da versão acima do documento da seção.
    • Forneça metadados de documentação da função.
    • Tenha o manipulador TestConnection.
    • Siga as convenções de nomenclatura (por exemplo, DataSourceKind.FunctionName). Ele não deve incluir palavras como "Malha", "Power BI", "Conector" ou "API".
    • Retornar dados em formato tabular, organizados em tabelas com colunas, como para uma fonte de dados relacional. Não há suporte para formatos multidimensionais baseados em cubos, dimensões e medidas.
    • Comporte-se da mesma forma no modo Import e DirectQuery, retornando resultados idênticos.
    • Tenha 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:

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

Segurança

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

  • Se Extension.CurrentCredentials() for utilizado:

    • O uso é obrigatório? Em caso afirmativo, para onde são enviadas as credenciais?
    • É garantido que os pedidos sejam feitos através de HTTPS?
      • Você pode usar a função auxiliar de imposição HTTPS.
    • Se as credenciais forem enviadas usando Web.Contents() via GET:
      • Pode ser transformado num POST?
      • Se GET for necessário, o conector DEVE usar o CredentialQueryString registro no Web.Contents() registro de opções para passar credenciais confidenciais.

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

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

  • Se Expression.Evaluate() for utilizado:

    • 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 a entrada do usuário.
    • O Expression não deve ser dinâmico (ou seja, recuperado de uma chamada web).

Após a Certificação

Depois que o conector for certificado e lançado por meio das experiências do Microsoft Fabric e do Microsoft Power BI, há algumas coisas que você deve fazer para garantir que possa usar corretamente o conector certificado publicamente disponível implantado em produção.

  • Você e os usuários finais devem usar a versão do conector certificado incluída em ambientes anteriores à certificação (como o Power BI Desktop e o Gateway de Dados) e remover todos os arquivos .mez ou .pqx existentes (conectores personalizados) usados antes da certificação. Se não o fizer, poderá resultar na utilização inadvertida do conector personalizado de teste pelo Power Query em vez do conector recém-certificado.
  • 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 que o teste for concluído e a nova versão do conector certificado estiver disponível.