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.
O procedimento atual de pré-visualização de onboarding cria bancos de dados Fabric HorizonDB no portal. Não estabelece suporte para operações de gerenciamento REST. Antes de automatizar, confirme se uma referência atual da API REST do Microsoft Fabric oferece suporte explicitamente à operação HorizonDB na versão prévia.
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
- Um espaço de trabalho Fabric elegível atribuído à capacidade ativa.
- Disponibilidade do Fabric HorizonDB na região do espaço de trabalho.
- Uma identidade Microsoft Entra com a função de workspace e as permissões da API listadas para a operação Fabric HorizonDB lançada.
- O identificador do espaço de trabalho.
- Um cliente que pode adquirir e proteger um token para a API Fabric.
Use o contrato liberado
Antes de escrever automação:
- Abra a referência da API Fabric REST.
- Confirme que a operação se aplica explicitamente ao Fabric HorizonDB.
- Use o caminho documentado, a versão da API, os requisitos de autenticação, as permissões, os cabeçalhos, o corpo da requisição, o corpo da resposta e o tratamento de status.
- Siga qualquer orientação referenciada do Microsoft Fabric para operações assíncronas, erros, limitações e tentativas.
- Teste a operação em um espaço de trabalho não produtivo antes de adicioná-la à automação gerenciada.
Não copie um endpoint, payload, tipo de item ou propriedade de outro produto de banco de dados Fabric. Durante a pré-visualização pública, o contrato suportado pode mudar, portanto valide a automação em relação à referência atual antes da implantação.
Inclua apenas propriedades que um esquema HorizonDB aplicável identifica como graváveis. Se não houver contrato aplicável disponível, use o procedimento de criação do portal em vez de inferir uma API a partir de outro item Fabric.
Adquirir um token da API do Fabric
Use uma biblioteca de autenticação Microsoft Entra compatível ou CLI do Azure para adquirir um token de acesso para a API Fabric. O recurso público do Fabric é:
https://api.fabric.microsoft.com
Para bibliotecas OAuth que exigem um escopo, use o escopo documentado na orientação atual de autenticação da API Fabric REST. Não coloque o token em uma URL, log, arquivo versionado ou transcrição de comando.
Envie o token conforme documentado via HTTPS. Conceda à identidade que chama apenas as permissões necessárias para a operação.
Enviar e validar uma solicitação
Compile a solicitação a partir da referência atual da API do Fabric HorizonDB.
Inclua apenas valores documentados e propriedades graváveis.
Envie a solicitação e processe a resposta exatamente conforme especifica a referência da operação.
Salve identificadores não sensíveis de recursos, solicitações, operações e correlação retornados pelo serviço para solução de problemas.
Após a operação de gerenciamento ser bem-sucedida, leia o item novamente e confirme a configuração efetiva.
Para criação, conecte-se como criador do banco de dados e execute:
SELECT current_database() AS database_name, current_user AS signed_in_user, current_setting('server_version') AS server_version, clock_timestamp() AS validated_at;
Somente a identidade Microsoft Entra que criou o banco de dados pode se conectar ao PostgreSQL na pré-visualização atual. Uma permissão de API de gerenciamento não habilita conexões PostgreSQL com principal de serviço ou identidade gerenciada.
Lidar com erros com segurança
- Trate a resposta documentada e o contrato de erro como oficiais.
- Corrija falhas de validação e autorização antes de tentar novamente.
- Use retentativas limitadas apenas quando as orientações de operação liberadas identificarem a solicitação como segura para tentar novamente.
- Não registre tokens de acesso, cabeçalhos de autorização, corpos de requisições que contenham valores sensíveis ou respostas de serviço não revisadas.
- Mantenha as informações de correlação antes de entrar em contato com o suporte.
- Antes da exclusão, revise as dependências. Trate a exclusão como irreversível durante a pré-visualização pública.