Crie uma listagem no Marketplace

Esta página descreve como criar partilhas e listagens no Databricks Marketplace para os seus produtos de dados.

Pré-requisitos

Você ou o seu administrador do Azure Databricks completaram o processo de configuração do fornecedor do Databricks Marketplace:

  • Inscreva-se para se tornar um fornecedor do Databricks Marketplace, público ou privado
  • Crie um perfil de fornecedor no Marketplace
  • Tenha a função de administrador do Marketplace atribuída a si

Para mais informações, consulte Torne-se um fornecedor do Databricks Marketplace.

Criar compartilhamentos

Observação

Para listar um produto de dados gratuito e disponível instantaneamente para os consumidores, você deve incluir um compartilhamento ao criar o anúncio. Os anúncios que exigem que você aprove uma solicitação do consumidor, por outro lado, não exigem que você inclua um compartilhamento no anúncio. Você pode criar o compartilhamento mais tarde, depois que todos os contratos comerciais forem concluídos e você tiver aprovado a solicitação do consumidor. Se é isso que queres fazer, avança para criar uma listagem.

Depois de ter uma conta Azure Databricks ativada para OpenSharing e um espaço de trabalho Azure Databricks ativado para o Unity Catalog, pode criar as partilhas que usa para partilhar os seus dados no Marketplace.

Uma partilha é um objeto OpenSharing. É uma coleção de tabelas, vistas, volumes, competências de agentes do Unity Catalog e modelos de IA que podem ser partilhados e protegidos como uma unidade. As tabelas podem ser partilhadas com qualquer consumidor. Volumes, competências de agentes, modelos de IA e notebooks só podem ser partilhados com consumidores que tenham acesso a um espaço de trabalho do Azure Databricks ativado para o Unity Catalog.

  1. Adicione tabelas de dados, exibições ou volumes ao metastore do Catálogo Unity.

    Para saber como criar esses ativos de dados no Unity Catalog, consulte:

  2. Crie um compartilhamento e adicione esses ativos de dados ao compartilhamento.

    Para saber como criar e atualizar partilhas, incluindo as permissões necessárias, consulte Criar partilhas para o OpenSharing.

Depois que seu compartilhamento for criado, você poderá criar ou atualizar uma listagem do Marketplace que faça referência a ele.

Exemplo de notebook: Notebook de exemplo

Para além de tabelas, volumes e vistas, o Databricks recomenda partilhar notebooks do Azure Databricks. Os cadernos podem ajudar a demonstrar exemplos de casos de uso e visualizar propriedades de tabelas. O seu anúncio pode incluir exemplos de pré-visualizações do bloco de notas que os consumidores podem importar para as suas áreas de trabalho.

Pré-visualização do notebook num anúncio

Para obter mais informações sobre como criar blocos de anotações, consulte Blocos de anotações Databricks. Se precisar de ajuda para criar um bloco de anotações de exemplo eficaz, entre em contato com dataproviders@databricks.com.

Observação

A visualização e a pré-visualização dos cadernos de exemplo na interface de listagens não funcionam no modo incógnito do Chrome.

O exemplo a seguir mostra como criar um bloco de anotações de exemplo eficaz. Inclui orientações para criar cadernos de exemplo para os seus anúncios.

Caderno inicial do Marketplace para provedores de dados

Obter notebook

Partilhe produtos de dados a partir do armazenamento atrás de um firewall

Se o armazenamento na cloud que apoia o seu produto de dados estiver protegido por um firewall de armazenamento ou só for acessível através de um endpoint privado, utilize o OpenSharing SecureConnect para que os consumidores possam aceder aos seus dados sem que inclua a rede de cada consumidor na lista. Como o Databricks Marketplace é baseado no OpenSharing, não é necessária nenhuma configuração específica do Marketplace: configure o SecureConnect na metastore do fornecedor que aloja as suas partilhas, e as suas listagens funcionam normalmente.

Para disponibilizar os seus produtos de dados através do SecureConnect:

  1. Ative o SecureConnect na metastore do fornecedor que hospeda as suas partilhas. O Databricks Marketplace cria um destinatário para cada consumidor quando acede a uma listagem, por isso ativar o SecureConnect ao nível da metastore aplica-o automaticamente aos destinatários criados posteriormente. Veja o Passo 2: Ative o SecureConnect numa metastore. Para um utilizador que acedeu à listagem antes de ativar a definição, ative o SecureConnect para esse destinatário existente em separado. Veja o Passo 3: Ative o SecureConnect para os destinatários individuais.
  2. Configure o seu firewall de armazenamento, ou conectividade privada através de uma configuração de conectividade de rede (NCC), para permitir o acesso a partir do plano de dados serverless do Azure Databricks. Veja o Passo 1: Configure o seu firewall de armazenamento.

Aplicam-se o suporte padrão do SecureConnect e as limitações. Para a matriz de suporte completa às funcionalidades e limitações, consulte Partilhar dados atrás de um firewall com o SecureConnect. Os consumidores que acedam ao seu anúncio a partir de plataformas de terceiros podem seguir as orientações do destinatário na configuração do firewall do destinatário OpenSharing para o SecureConnect.

Crie uma listagem

As listagens do Marketplace permitem que os consumidores naveguem, selecionem e acessem seus produtos de dados. Todas as listagens de conjuntos de dados são automaticamente partilháveis tanto com os consumidores nos espaços de trabalho do Azure Databricks como com os consumidores em plataformas de terceiros como Power BI, pandas e Apache Spark.

Observação

Alguns ativos de dados, como os volumes do Unity Catalog, só podem ser partilhados com consumidores que tenham acesso a um espaço de trabalho Azure Databricks habilitado pelo Unity Catalog. As tabelas, no entanto, são partilháveis com todos os consumidores. Se incluir tabelas e volumes numa partilha, os consumidores que não têm acesso a um espaço de trabalho com Unity Catalog só podem aceder aos dados tabulares. Listagens que incluem competências de agente (Beta) só podem ser instaladas por um destinatário do Azure Databricks. Para requisitos e limitações, consulte Adicionar competências de agente a uma partilha.

Observação

Se o seu espaço de trabalho utiliza o perfil de segurança de conformidade, é responsável por garantir que as competências dos agentes de listagem para consumidores noutras regiões cumprem os seus requisitos de conformidade e residência de dados. As competências são partilhadas diretamente da sua metastore para a metastore do consumidor, e você escolhe quais os anúncios a publicar.

Permissões necessárias:Função de administrador do Marketplace. Se estiver a criar e gerir anúncios personalizados (aqueles que exigem aprovação do provedor antes de serem concretizados), também deve ter os privilégios CREATE RECIPIENT e USE RECIPIENT. Consulte a referência de privilégios do Unity Catalog.

Para criar um anúncio:

  1. Inicie sessão no seu espaço de trabalho Azure Databricks.
  2. Na barra lateral, clique em Ícone do MarketplaceMarketplace.
  3. No canto superior direito da página do Marketplace, clique em Console do Provedor.
  4. Na guia Listagens da página do console do provedor, clique em Criar listagem.
  5. Na página Novo anúncio, introduza as informações do seu anúncio. Cada página do assistente de listagem é descrita em Preencher campos e opções da listagem.

Preencha os campos e opções da listagem

O assistente de listagem orienta-o na publicação de uma listagem no Marketplace. Esta secção descreve os campos e opções em cada página, juntamente com recomendações para criar uma listagem eficaz. Durante cada etapa, pode guardar o seu progresso como rascunho e visualizar uma antevisão antes de publicar.

Depois de preencher todos os campos, clique em Publicar.

Passo 1: Geral

Especifique a informação básica sobre o seu anúncio, como o nome e o perfil do prestador sob o qual deve publicar o anúncio.

Nome do campo Descrição
Nome do anúncio Cada anúncio deve ter um nome exclusivo que ajude os consumidores a compreender o que oferece.
Recommendations:
  • Menos de 100 caracteres.
  • Caso do título (colocar palavras primárias em maiúsculas).
Perfil do fornecedor O nome da sua organização ou empresa. Selecione no menu suspenso. O Azure Databricks cria o seu perfil como parte do processo de aprovação da organização parceira.
Como podem os consumidores aceder aos ativos de dados no anúncio? Este campo não pode ser alterado depois de a listagem ser guardada como rascunho ou publicada. Escolha como os seus consumidores acedem à listagem:
  • Os ativos de dados são instantaneamente acessíveis: Permitir que os consumidores acedam diretamente aos dados partilhados a partir do Marketplace, sem exigir a sua aprovação (mas sem aceitar os termos de serviço).
  • Os consumidores devem pedir acesso à listagem: Selecione esta opção para exigir a sua aprovação antes de um consumidor poder aceder aos dados partilhados. Use esta opção se precisar de um contrato comercial antes de disponibilizar o produto de dados aos consumidores. Você deve gerenciar o contrato comercial com consumidores fora do Databricks Marketplace. Você pode iniciar comunicações usando o endereço de e-mail do consumidor. Visualize e trate solicitações de consumidores na guia Solicitações de consumidores do Console > do provedor . Consulte Gerenciar solicitações para seu produto de dados no Databricks Marketplace.
Publicar em Escolha uma das seguintes opções:
  • Mercado Público
    • Todos os consumidores podem navegar e visualizar a listagem no Databricks Marketplace público.
  • Troca privada
    • Apenas os consumidores que são membros de uma bolsa privada, criada por si ou por outro administrador do Marketplace, podem navegar, ver e solicitar o anúncio. Consulte Criar e gerenciar trocas privadas no Databricks Marketplace. Deve selecionar pelo menos uma bolsa de valores privada na lista suspensa.

Passo 2: Ativos de dados

Selecione que tipos de ativos de dados incluir no seu anúncio.

Nome do campo Descrição
Tables Inclua dados tabulares estruturados da sua partilha.
Ficheiros Volumes que contêm uma variedade de dados, como imagens, áudio, vídeo e mais.
Models Modelos de IA que os consumidores podem implementar para inferência.
Competências de agente Instruções orientadas que ensinam os agentes a trabalhar com os seus dados ou domínio. As listas de competências dos agentes estão em Beta. Só os consumidores que usam Azure Databricks podem instalar anúncios com competências de agente. Para requisitos e limitações, consulte Adicionar competências de agente a uma partilha.
Notebooks Cadernos interativos para fluxos de trabalho de ciência de dados e aprendizagem automática. Para mais informações, consulte Exemplo de Bloco de Notas: Exemplo de Bloco de Notas.
Visualizações métricas Inclua métricas de negócio governadas a partir de uma vista de métricas num compartilhamento. Apenas os consumidores no Azure Databricks podem usar vistas métricas partilhadas. Para requisitos e limitações, consulte Adicionar vistas de métricas a uma partilha.
Servidor MCP Os servidores Model Context Protocol (MCP) são ferramentas e APIs que os agentes podem usar para interagir com sistemas externos. Apenas outros utilizadores que utilizam Azure Databricks podem instalar servidores MCP listados no Marketplace. Para mais detalhes sobre o processo de configuração, consulte os campos de listagem do servidor MCP.
Quando seleciona esta opção, preenche os campos obrigatórios e avança para o passo seguinte, o anúncio é guardado automaticamente.
Selecionar partilha Se escolheu incluir tabelas, ficheiros, modelos, cadernos, competências de agente ou vistas métricas na sua listagem, selecione a share que contém os ativos de dados para a sua listagem. Pode criar um novo compartilhamento se necessário. Para mais informações, consulte Criar partilhas.

Passo 3: Atributos

Adicione atributos e categorias para tornar o seu anúncio mais acessível.

Nome do campo Descrição
Categorias Selecione as categorias que os consumidores podem usar para filtrar os anúncios. As categorias também aparecem como tags em blocos de listagem e páginas de detalhes.
Frequência de atualização (opcional) Especifique com que frequência o ativo de dados no seu anúncio é atualizado no Azure Databricks.
Atributos avançados Atributos avançados de dados são opcionais. Incluem áreas como cobertura geográfica, granularidade da coleção e intervalo temporal. Adicionar atributos ajuda os consumidores a entender mais sobre seu produto de dados. Selecione quantos atributos quiser.

Passo 4: Detalhes

Forneça uma breve descrição e uma descrição detalhada para ajudar os consumidores a compreender que ativos de dados estão incluídos no seu anúncio. Também pode adicionar recursos como cadernos de exemplo, links para documentação e URLs de políticas.

Nome do campo Descrição
Breve descrição Uma explicação breve e informativa do conjunto de dados que expande o nome do anúncio. Este campo aparece nos azulejos de listagem e nos resultados de pesquisa do utilizador.
Recommendations:
  • Menos de 100 caracteres. Não pode exceder 160 caracteres.
  • Caso da frase (colocar em maiúscula apenas a primeira palavra e quaisquer nomes próprios ou siglas).
Descrição A descrição detalhada dos seus dados deve incluir um resumo dos dados e ativos oferecidos na listagem.
A formatação básica de rich text é suportada (ou seja, negrito, itálico, marcadores e listas numeradas), usando a sintaxe Markdown.
Recommendations:
  • Inclua benefícios e casos de uso.
  • Forneça orientações breves sobre como usar os dados e exemplos de casos de uso.
  • Inclua conjuntos de dados de exemplo e nomes de campos.
  • Especifique esquemas, tabelas e colunas.
  • Use pontuação e sintaxe consistentes.
  • Adicione uma quebra de linha extra entre parágrafos.
  • Não repita os atributos que definiu em Adicionar Atributo.
Adicionar bloco de notas A Databricks recomenda que partilhe cadernos de exemplo para demonstrar a melhor forma de utilizar os dados e aumentar o número de downloads de anúncios. Adicione até 10 blocos de notas. Para obter mais informações sobre como criar blocos de anotações, consulte Exemplo de bloco de anotações: bloco de anotações de exemplo e blocos de anotações Databricks.
Clicar em Adicionar caderno grava automaticamente a lista.
Documentação Um URL que liga a documentação que pode ajudar os consumidores a usar ou compreender o seu conjunto de dados (por exemplo, um dicionário de conjuntos de dados).
Política de privacidade Um URL com links para sua política de privacidade. A política de privacidade deve ser acessível ao público e não requer login.
Licença Um URL vinculado à sua licença.
Termos de serviço Um URL que vincula aos seus termos de serviço para o uso apropriado dos ativos de dados compartilhados. Os termos de serviço devem ser acessíveis ao público e não exigem login.

Campos de listagem do servidor MCP

Os servidores Model Context Protocol (MCP) são ferramentas e APIs que os agentes podem usar para interagir com sistemas externos. Você pode listar servidores MCP na categoria de produto "IA" no Marketplace para torná-los detetáveis para engenheiros de IA que estão construindo agentes.

Ao criar uma listagem de servidor MCP, preencha os mesmos campos de listagem básicos que para listagens de conjuntos de dados, além dos seguintes campos específicos de MCP:

Nome do campo Descrição
Tipo de autenticação Especifique o método de autenticação que o servidor MCP requer:
  • Bearer token: Para autenticação baseada em chave de API ou token.
  • OAuth Utilizador para Máquina por Utilizador: Para autenticação OAuth 2.0 por utilizador. Requer endpoints de token e de autorização.
  • OAuth Machine to Machine (Credenciais do Cliente): Para autenticação OAuth 2.0 partilhada por todos os utilizadores do servidor MCP instalado. Requer um endpoint de token.
  • Registo Dinâmico de Clientes: Para autenticação OAuth 2.0 por utilizador quando o seu servidor MCP suporta o registo dinâmico de clientes. O Azure Databricks descobre os endpoints OAuth e regista um cliente quando um consumidor instala o servidor MCP.
Host O nome do host ou domínio onde o servidor MCP está acessível.
Porto O número da porta de rede que o servidor MCP escuta.
Caminho base (opcional) O prefixo do caminho de URL para os endpoints da API do servidor MCP. Deixe em branco se o servidor MCP estiver hospedado no caminho raiz.
Tag (Opcional) Um identificador de versão ou tag de liberação para seu servidor MCP.
Endpoint de token (OAuth Utilizador para Máquina por Utilizador e OAuth Máquina para Máquina apenas) O ponto de extremidade do servidor de autorização OAuth 2.0 usado para obter tokens de acesso.
Ponto de extremidade de autorização (somente usuário OAuth para máquina por usuário) O endpoint do servidor de autorização OAuth 2.0 utilizado para obter códigos de autorização. Os utilizadores são redirecionados para este endpoint para autenticar e autorizar o acesso ao seu servidor MCP.
Escopo OAuth (apenas tipos de autenticação OAuth, opcional) O escopo de permissões do OAuth 2.0 que define quais recursos e operações os consumidores podem acessar.
Método de troca de credenciais OAuth (somente usuário para máquina OAuth por usuário) Como as credenciais OAuth 2.0 são trocadas.

Para o Registo Dinâmico de Clientes, não especifique pontos de extremidade de token nem de autorização. O seu servidor MCP externo deve suportar o Registo Dinâmico de Clientes OAuth 2.0 e expor os endpoints de metadados OAuth para descoberta automática. Os consumidores não inserem um ID de cliente ou segredo de cliente durante a instalação. Cada utilizador autoriza o acesso após a instalação através da página do Serviço MCP. Para mais informações sobre o Registo Dinâmico de Clientes, consulte Criar uma ligação ao serviço externo.

Analise a atividade do consumidor usando tabelas do sistema (Visualização pública) e painéis

Se as tabelas do sistema estiverem ativadas na sua conta, pode usar as tabelas do sistema do Marketplace para analisar a atividade dos consumidores nos seus anúncios. Para obter mais informações, consulte Referência de tabelas do sistema do Marketplace.

Você também pode usar o Painel de Análise de Fornecedores para monitorar visualizações, solicitações e instalações das listagens. O painel extrai dados das tabelas do sistema. Consulte Monitorização das métricas de utilização de listagens usando painéis.

Quotas de recursos

Unity Catalog impõe quotas de recursos em todos os objetos securizáveis, incluindo listagens do Marketplace por metastore e provedores por cada conta. Essas cotas estão listadas em Limites de recursos. Se espera ultrapassar estes limites de recursos, contacte a sua equipa de contas no Azure Databricks.

Você pode monitorar o uso da cota usando as APIs de cotas de recursos do Unity Catalog. Consulte Monitorar o uso das cotas de recursos do Unity Catalog.

Recursos adicionais