Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Create a Fabric HorizonDB database through the Fabric portal. The current preview onboarding procedure uses HorizonDB database (preview) in + New item.
Important
Fabric HorizonDB is in public preview. Capabilities, limits, and behavior might change before general availability. For more information, see Microsoft Fabric preview features.
Prerequisites
Every creation method requires:
- An eligible Fabric workspace assigned to active capacity.
- Contributor or Admin access and permission to create the PostgreSQL database item.
- Fabric HorizonDB availability in the workspace region.
- A Microsoft Entra user enabled for the preview. Only this database creator can connect to PostgreSQL afterward.
Compare creation methods
| Method | Best for | Important behavior |
|---|---|---|
| Fabric portal | Interactive creation, learning, and validating workspace readiness | The portal validates the name, workspace, capacity, region, permission, and supported configuration. |
| Fabric REST API | Automation only when an applicable HorizonDB operation is explicitly documented for your preview | General Fabric item APIs don't establish support for this database type. |
The service manages compute. Use only configuration choices exposed by your preview database item.
Use the Fabric portal
Use the portal for the shortest supported path:
- Open the target workspace.
- Select + New item.
- Search for HorizonDB database, and select HorizonDB database (preview).
- Enter a unique name and any released optional configuration.
- Submit creation and wait for the item operation to finish.
- Validate the PostgreSQL endpoint with an authorized query.
For the complete procedure, see Create a HorizonDB database.
Use the REST API
The onboarding procedure doesn't establish a HorizonDB REST management contract. Before automating, confirm that a current API reference explicitly supports the operation for your preview. Don't construct an endpoint or request body by inference. Check:
- Resource path and API version.
- Microsoft Entra permissions.
- Writable and read-only fields.
- Request and response schemas.
- Error and retry guidance.
For customer-safe automation guidance, see Manage Fabric HorizonDB with the REST API.
Validate every created database
Regardless of the creation surface:
- Follow the completion behavior documented by the selected creation surface.
- Read the effective item state instead of assuming the submitted configuration is already active.
- Open an authorized PostgreSQL connection.
- Run the validation query in Create a HorizonDB database.
- Check integration status separately.