Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Esta página descreve como criar compartilhamentos e listagens do Databricks Marketplace para seus produtos de dados.
Pré-requisitos
Você ou o administrador do Azure Databricks concluiu o processo de instalação do provedor do Databricks Marketplace:
- Inscreva-se para se tornar um provedor do Databricks Marketplace, público ou privado
- Criar um perfil de provedor do Marketplace
- Ter a função de administrador do Marketplace atribuída a você
Para obter mais informações, consulte Tornar-se um provedor 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 a listagem. As listagens que exigem que você aprove uma solicitação do consumidor, por outro lado, não exigem que você inclua uma participação na listagem. Você pode criar o compartilhamento posteriormente, depois que todos os contratos comerciais forem concluídos e você tiver aprovado a solicitação do consumidor. Se é isso que você deseja fazer, pule para criar uma listagem.
Depois de ter uma conta do Azure Databricks habilitada para o OpenSharing e um workspace do Azure Databricks habilitado para o Catálogo do Unity, você pode criar os compartilhamentos que usa para compartilhar seus dados no Marketplace.
Um compartilhamento é um objeto OpenSharing. É uma coleção de tabelas, views, volumes, habilidades de agentes do Unity Catalog e modelos de IA que são compartilháveis e protegidos como uma unidade. As tabelas podem ser compartilhadas com qualquer consumidor. Volumes, habilidades de agentes, modelos de IA e notebooks só podem ser compartilhados com consumidores que têm acesso a um espaço de trabalho do Azure Databricks habilitado para o Unity Catalog.
Adicione tabelas de dados, exibições ou volumes ao metastore do Catálogo do Unity.
Para saber como criar esses ativos de dados no Catálogo do Unity, confira:
Crie um compartilhamento e adicione esses ativos de dados a ele.
Para saber como criar e atualizar compartilhamentos, incluindo as permissões necessárias, consulte Criar compartilhamentos para OpenSharing.
Depois que o 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
Além de tabelas, volumes e exibições, o Databricks recomenda o compartilhamento de notebooks do Azure Databricks. Notebooks podem ajudar a visualizar propriedades de tabela e a demonstrar exemplos de casos de uso. Sua listagem pode incluir pré-visualizações de notebooks de exemplo que os consumidores podem importar para seus workspaces.
Para obter mais informações sobre como criar notebooks, consulte notebooks do Databricks. Se você precisar de ajuda para criar um notebook de exemplo eficaz, entre em contato com dataproviders@databricks.com.
Observação
Os Notebooks de exemplo não são exibidos nem visualizados na interface de listagem no modo de navegação anônima do Chrome.
O exemplo a seguir mostra como criar um notebook de exemplo eficaz. Ele inclui diretrizes para criar blocos de anotações de exemplo para suas listagens.
Notebook inicial do Marketplace para provedores de dados
Compartilhe produtos de dados a partir do armazenamento atrás de um firewall
Se o armazenamento em nuvem que sustenta seu produto de dados estiver protegido por um firewall de armazenamento ou for acessível apenas por meio de um endpoint privado, use o OpenSharing SecureConnect para que os consumidores possam acessar seus dados sem que você coloque a rede de cada consumidor na lista de informações. Como o Databricks Marketplace é construído sobre o OpenSharing, nenhuma configuração específica do Marketplace é necessária: configure o SecureConnect na metastore do provedor que hospeda seus compartilhamentos, e seus anúncios funcionam normalmente.
Para disponibilizar seus produtos de dados através do SecureConnect:
- Ative o SecureConnect na metastore do provedor que hospeda seus compartilhamentos. O Databricks Marketplace cria um destinatário para cada consumidor quando ele tem acesso a uma listagem, então ativar o SecureConnect no nível da metastore o aplica automaticamente aos destinatários criados posteriormente. Veja o Passo 2: Ative o SecureConnect em uma metastore. Para um usuário que acessou a listagem antes de você ativar essa configuração, ative o SecureConnect para esse destinatário existente separadamente. Consulte a Etapa 3: Habilitar o SecureConnect para destinatários individuais.
- Configure seu firewall de armazenamento ou conectividade privada por meio de uma configuração de conectividade de rede (NCC) para permitir o acesso do plano de dados sem servidor do Azure Databricks. Veja o Passo 1: Configure seu firewall de armazenamento.
O suporte padrão do SecureConnect e as limitações se aplicam. Para a matriz de suporte completa e limitações de recursos, veja Compartilhar dados atrás de um firewall com o SecureConnect. Consumidores que acessam seu anúncio por plataformas de terceiros podem seguir as orientações para destinatários na configuração do firewall de destinatários do OpenSharing para o SecureConnect.
Criar 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 compartilháveis com consumidores nos workspaces do Azure Databricks e com consumidores em plataformas de terceiros, como Power BI, pandas e Apache Spark.
Observação
Alguns ativos de dados, como volumes do Unity Catalog, só podem ser compartilhados com consumidores que têm acesso a um workspace Azure Databricks com Unity Catalog habilitado. As tabelas, no entanto, são compartilháveis com todos os consumidores. Se você incluir tabelas e volumes em um compartilhamento, os consumidores que não têm acesso a um workspace habilitado para Catálogo do Unity só poderão acessar os dados tabulares. Listagens que incluem habilidades de agente (Beta) só podem ser instaladas por um destinatário do Azure Databricks. Para requisitos e limitações, veja Adicionar habilidades de agente a um compartilhamento.
Observação
Se seu espaço de trabalho utiliza o perfil de segurança de conformidade, você é responsável por garantir que as habilidades de agente de listagem para consumidores em outras regiões atendam aos seus requisitos de conformidade e residência de dados. As habilidades são compartilhadas diretamente da sua metastore para a metastore do consumidor, e você escolhe quais anúncios publicar.
Permissões necessárias:Função de administrador do Marketplace. Se você estiver criando e gerenciando listagens personalizadas (aquelas que exigem aprovação do provedor antes de serem atendidas), você também deve ter os privilégios CREATE RECIPIENT e USE RECIPIENT. Consulte Referência de privilégios do Unity Catalog.
Para criar uma listagem:
- Faça logon no workspace Azure Databricks.
- Na barra lateral, clique em
Marketplace. - No canto superior direito da página do Marketplace, clique no console do Provedor.
- Na página do Console do provedor, na guia Listagens, clique em Criar listagem.
- Na página Nova listagem, insira suas informações de listagem. Cada página no assistente de listagem é descrita em Preencher campos e opções de listagem.
Preencher campos e opções de listagem
O assistente de listagem orienta você pela publicação de uma listagem do Marketplace. Esta seção descreve os campos e as opções em cada página, juntamente com recomendações para criar uma listagem eficaz. Durante cada etapa, você pode salvar seu progresso como um rascunho e exibir uma visualização antes de publicar.
Depois de preencher todos os campos, clique em Publicar.
Etapa 1: Geral
Especifique as informações básicas sobre sua listagem, como o nome e o perfil do provedor no qual publicar a listagem.
| Nome do campo | Descrição |
|---|---|
| Nome da listagem | Cada listagem deve ter um nome exclusivo que ajude os consumidores a entender o que ele oferece. Recomendações:
|
| Perfil do provedor | Nome da sua organização ou empresa. Selecione no menu suspenso. Azure Databricks cria seu perfil como parte do processo de aprovação da organização parceira. |
| Como os consumidores podem acessar ativos de dados na listagem? | Esse campo não pode ser alterado depois que a listagem é salva como um rascunho ou publicada. Escolha como seus consumidores obtêm acesso à listagem:
|
| Publicar em | Escolha uma destas opções:
|
Etapa 2: Ativos de dados
Selecione quais tipos de ativos de dados incluir em sua listagem.
| Nome do campo | Descrição |
|---|---|
| Tabelas | Inclua dados tabulares estruturados do seu compartilhamento. |
| Arquivos | Volumes que contêm uma variedade de dados, como imagens, áudio, vídeo e muito mais. |
| Models | Modelos de IA que os consumidores podem implantar para inferência. |
| Habilidades do agente | Instruções governadas que ensinam os agentes a trabalhar com seus dados ou domínio. As listas de habilidades dos agentes estão em Beta. Apenas consumidores que usam Azure Databricks podem instalar listagens com habilidades de agente. Para requisitos e limitações, veja Adicionar habilidades de agente a um compartilhamento. |
| Notebooks | Notebooks interativos para fluxos de trabalho de ciência de dados e machine learning. Para obter mais informações, consulte o exemplo do Bloco de Anotações: bloco de anotações de exemplo. |
| Exibições de métricas | Inclua métricas empresariais governadas a partir de uma visão de métrica em um compartilhamento. Somente consumidores no Azure Databricks podem usar visualizações métricas compartilhadas. Para requisitos e limitações, veja Adicionar visualizações de métricas a um compartilhamento. |
| Servidor MCP | Os servidores MCP (Model Context Protocol) são ferramentas e APIs que os agentes podem usar para interagir com sistemas externos. Somente outros usuários que usam Azure Databricks podem instalar servidores MCP listados no Marketplace. Para obter mais detalhes sobre o processo de instalação, consulte os campos de listagem do servidor MCP. Quando você seleciona essa opção, preenche os campos necessários e avança para a próxima etapa, a listagem é salva automaticamente. |
| Selecionar compartilhamento | Se você escolheu incluir tabelas, arquivos, modelos, cadernos, habilidades de agentes ou visualizações métricas na sua listagem, selecione o share que contém os ativos de dados da sua listagem. Você pode criar um novo compartilhamento, se necessário. Para obter mais informações, consulte Criar compartilhamentos. |
Etapa 3: Atributos
Adicione atributos e categorias para tornar sua listagem mais detectável.
| Nome do campo | Descrição |
|---|---|
| Categorias | Selecione as categorias que os consumidores podem usar para filtrar listagens. As categorias também aparecem como marcas na listagem de blocos e páginas de detalhes. |
| Frequência de atualização (opcional) | Especifique com que frequência o ativo de dados em sua listagem é atualizado em Azure Databricks. |
| Atributos avançados | Atributos de dados avançados são opcionais. Eles incluem campos como cobertura geográfica, granularidade da coleção e intervalo de tempo. Adicionar atributos ajuda os consumidores a entender mais sobre seu produto de dados. Selecione quantos atributos desejar. |
Etapa 4: Detalhes
Forneça uma breve descrição e uma descrição detalhada para ajudar os consumidores a entender quais ativos de dados estão incluídos em sua listagem. Você também pode adicionar recursos, como notebooks de exemplo, links de documentação e URLs de política.
| Nome do campo | Descrição |
|---|---|
| Descrição curta | Uma explicação breve e informativa do conjunto de dados que complementa o nome da listagem. Esse campo aparece nos blocos de listagem e nos resultados de pesquisa do consumidor. Recomendações:
|
| Descrição | A descrição detalhada de seus dados deve incluir um resumo dos dados e ativos que estão sendo oferecidos na listagem. Há suporte para formatação básica de rich text (ou seja, negrito, itálico, marcadores e listas numeradas), usando a sintaxe Markdown. Recomendações:
|
| Adicionar notebook | O Databricks recomenda que você compartilhe notebooks de exemplo para demonstrar a melhor maneira de usar os dados e aumentar os downloads de listagem. Adicione até 10 cadernos. Para obter mais informações sobre como criar notebooks, consulte Exemplo de Notebook: Notebook de Exemplo e notebooks do Databricks. Clicar em Adicionar bloco de anotações salva automaticamente a listagem. |
| Documentação | Uma URL vinculada à documentação que pode ajudar os consumidores a usar ou entender seu conjunto de dados (por exemplo, um dicionário de conjunto de dados). |
| Política de privacidade | Uma URL vinculada à política de privacidade. A política de privacidade deve ser acessível publicamente e não requer logon. |
| Licença | Uma URL que é vinculada à sua licença. |
| Termos de serviço | Uma URL vinculada aos seus termos de serviço para o uso apropriado dos ativos de dados compartilhados. Os termos de serviço devem ser acessíveis publicamente e não exigem logon. |
Campos de listagem de servidor MCP
Os servidores MCP (Model Context Protocol) 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 detectáveis para engenheiros de IA que estão criando agentes.
Ao criar uma listagem de servidor MCP, conclua os mesmos campos de listagem básicos que para listagens de conjunto de dados, além dos seguintes campos específicos do MCP:
| Nome do campo | Descrição |
|---|---|
| Tipo de autenticação | Especifique o método de autenticação necessário para o servidor MCP:
|
| Anfitrião | O nome do host ou domínio em que o servidor MCP está acessível. |
| Porto | O número da porta de rede na qual o servidor MCP está escutando. |
| Caminho base (opcional) | O prefixo de caminho de URL para os pontos de extremidade da API do servidor MCP. Deixe em branco se o servidor MCP estiver hospedado no caminho raiz. |
| Etiqueta (opcional) | Um identificador de versão ou etiqueta de lançamento para o servidor MCP. |
| Endpoint do token (apenas OAuth de Usuário para Máquina por usuário e OAuth de Máquina para Máquina) | O ponto de extremidade do servidor de autorização OAuth 2.0 usado para obter tokens de acesso. |
| Ponto de extremidade da autorização (somente usuário OAuth para máquina por usuário) | O ponto de extremidade do servidor de autorização do OAuth 2.0 usado para obter códigos de autorização. Usuários são redirecionados para este endpoint para autenticar e autorizar o acesso ao seu servidor MCP. |
| Escopo OAuth (apenas tipos de autenticação OAuth, opcionais) | 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 OAuth para máquina por usuário) | Como as credenciais do OAuth 2.0 são trocadas. |
Para Registro Dinâmico de Cliente, não especifique endpoints de token nem de autorização. Seu servidor MCP externo deve suportar o OAuth 2.0 Dynamic Client Registration e expor os endpoints de metadados OAuth para descoberta automática. Os consumidores não digitam um ID de cliente ou segredo de cliente durante a instalação. Cada usuário autoriza o acesso após a instalação usando a página do Serviço MCP. Para mais informações sobre o Registro Dinâmico de Clientes, veja Criar uma conexão com o serviço externo.
Analise a atividade do consumidor usando tabelas do sistema (Visualização Pública) e painéis
Se você tiver tabelas de sistema habilitadas em sua conta, poderá usar as tabelas de sistema do Marketplace para analisar a atividade do consumidor em suas listagens. Para obter mais informações, confira Referência das tabelas do sistema do Marketplace.
Você também pode usar o Painel de Análise do Provedor para monitorar exibições de listagem, solicitações e instalações. O painel extrai dados das tabelas do sistema. Consulte Monitorar listagem de métricas de uso usando painéis.
Cotas de recursos
O Catálogo do Unity aplica cotas de recursos a todos os objetos que podem ser protegidos, incluindo listagens do Marketplace por metastore e provedores por conta. Essas cotas são listadas em Limites de recursos. Se você espera exceder esses limites de recursos, entre em contato com sua equipe de conta do Azure Databricks.
Você pode monitorar o uso da cota usando as APIs de cotas de recursos do Catálogo do Unity. Consulte Monitorar o uso de cotas de recursos do Catálogo do Unity.