Opções para criar um banco de dados HorizonDB

Crie um banco de dados HorizonDB do Fabric pelo portal Fabric. O procedimento atual de integração da versão prévia usa banco de dados HorizonDB (pré-visualização) na opção + Novo item.

Importante

Fabric HorizonDB está em prévia pública. Capacidades, limites e comportamento podem mudar antes da disponibilidade geral. Para mais informações, consulte os recursos de pré-visualização do Microsoft Fabric.

Prerequisites

Todo método de criação requer:

  • Um espaço de trabalho Fabric elegível atribuído à capacidade ativa.
  • Acesso de Colaborador ou Administrador e permissão para criar o item de banco de dados PostgreSQL.
  • Disponibilidade do Fabric HorizonDB na região do espaço de trabalho.
  • Um usuário do Microsoft Entra habilitado para a prévia. Somente este criador de banco de dados pode se conectar ao PostgreSQL posteriormente.

Comparar métodos de criação

Método Mais indicado para Comportamento importante
portal do Fabric Criação interativa, aprendizado e validação da prontidão do espaço de trabalho O portal valida o nome, espaço de trabalho, capacidade, região, permissão e configuração suportada.
API REST do Fabric Automação somente quando uma operação HorizonDB aplicável for explicitamente documentada para sua pré-visualização As APIs de itens do Fabric geral não estabelecem suporte para esse tipo de banco de dados.

O serviço gerencia o processamento. Use apenas as opções de configuração expostas pelo seu item de banco de dados de visualização.

Use o portal Fabric

Use o portal para o caminho compatível mais curto:

  1. Abra o espaço de trabalho de destino.
  2. Escolha + Novo item.
  3. Pesquise por banco de dados HorizonDB e selecione Banco de dados HorizonDB (prévia).
  4. Digite um nome exclusivo e qualquer configuração opcional liberada.
  5. Envie a criação e aguarde a operação do item ser concluída.
  6. Valide o endpoint PostgreSQL com uma consulta autorizada.

Para o procedimento completo, consulte Criar um banco de dados HorizonDB.

Usar a API REST

O procedimento de onboarding não estabelece um contrato de gerenciamento REST do HorizonDB. Antes de automatizar, confirme se uma referência de API atual suporta explicitamente a operação para sua versão preview. Não construa um endpoint ou um corpo de solicitação por inferência. Verifique:

  • Caminho do recurso e versão da API.
  • Permissões do Microsoft Entra.
  • Campos graváveis e somente de leitura.
  • Esquemas de solicitação e resposta.
  • Orientação sobre erro e nova tentativa.

Para orientações de automação segura para o cliente, consulte Gerenciar o Fabric HorizonDB com a API REST.

Valide cada banco de dados criado

Independentemente da superfície de criação:

  1. Siga o comportamento de conclusão documentado pela superfície de criação selecionada.
  2. Leia o estado efetivo do item em vez de assumir que a configuração enviada já está ativa.
  3. Abra uma conexão PostgreSQL autorizada.
  4. Execute a consulta de validação em Criar um banco de dados HorizonDB.
  5. Verifique o status da integração separadamente.