Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
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:
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.
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
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:
- 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.
- 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:
- Inicie sessão no seu espaço de trabalho Azure Databricks.
- Na barra lateral, clique em
Marketplace. - No canto superior direito da página do Marketplace, clique em Console do Provedor.
- Na guia Listagens da página do console do provedor, clique em Criar listagem.
- 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:
|
| 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:
|
| Publicar em | Escolha uma das seguintes opções:
|
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:
|
| 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:
|
| 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:
|
| 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.