Bouw de Databricks Network Connectivity Configuration, private-endpointregels en workspacebinding waarmee een serverless SQL warehouse Azure Data Lake Gen2 via een privaat pad kan bereiken.
Maak NCC
mws_network_connectivity_config
Maak blob + dfs-regels
mws_ncc_private_endpoint_rule
Workspace koppelen
mws_ncc_binding
Goedkeuren op Azure-resource
Private endpoint-connection wordt bruikbaar
Terraform-automatisering voor dataplatformen
Wat deze gids bouwt
Het target is bewust smal: een Databricks serverless SQL warehouse moet data bevragen die is opgeslagen in een Azure Data Lake Gen2-account waarvan public network access is beperkt.
Deze gids automatiseert de Databricks-accountobjecten die dat pad tot stand brengen. Hij vervangt inbound Private Link, classic-compute VNet-design of Unity Catalog-permissies niet.
Eerst de architectuurbeslissing nodig? Lees Private Link versus NCCScope van deze implementatie
Serverless SQL
Databricks-beheerde serverless compute plane
ADLS Gen2
Azure Storage in eigendom van de klant
Runtimepad
Serverless compute draait niet binnen je VNet-injected classic compute-subnets. Private outbound access naar Azure-resources van de klant wordt daarom geconfigureerd via een Network Connectivity Configuration.
Serverless SQL private datapad
Dit is outbound connectivity vanuit Databricks naar je Azure-resource.
Compute
Serverless SQL warehouse
Draait in de Azure Databricks serverless compute plane.
Netwerkcontrol
NCC + private endpoint rule
Een klantcase die laat zien hoe Titan Foodware 365-data ontsluit voor betrouwbare rapportage, dashboards en AI-ready fundamenten.
Bestemming
Azure Data Lake Gen2
Private endpoint-connection goedgekeurd op het storageaccount.
Geen inbound Private Link
Gebruiker-naar-workspace-toegang is een ander netwerkpad.
Geen VNet injection
Dat patroon hoort bij classic-compute networking.
Heeft nog steeds data-autorisatie nodig
Private transport verleent geen Unity Catalog- of Azure-storagepermissions.
terraform.tfstate
Alle drie de resources zijn account-level. De NCC en workspace moeten in dezelfde Azure-regio staan en een workspace kan maar aan één NCC tegelijk gekoppeld zijn.
Als een workspace meerdere private bestemmingen nodig heeft, plaats de endpoint rules dan in dezelfde NCC in plaats van meerdere NCC's te proberen te koppelen.
databricks_mws_network_connectivity_config
Maakt de regionale NCC
De container voor serverless egress rules.
databricks_mws_ncc_private_endpoint_rule
Vraagt een private endpoint aan
Richt zich op een Azure-resource-ID en subresource zoals blob of dfs.
databricks_mws_ncc_binding
Koppelt de NCC aan de workspace
Maakt de NCC-configuratie beschikbaar voor serverless workloads in die workspace.
Vereisten
De meeste mislukte implementaties zijn geen HCL-problemen. Het zijn mismatches tussen de Databricks-accountgrens, workspace-regio, Azure-resourcepermissions en eigenaarschap van endpoint approval.
Outbound Private Link for serverless compute requires the Premium plan.
NCCs and private endpoint rules are managed at the Databricks account level.
The NCC must match the Azure region of the workspace it is attached to.
The target resource owner must approve the pending private endpoint connection.
Dependencygraph
Maak eerst de regionale NCC. Endpointregels verwijzen naar die NCC en de Azure Storage-resource. De workspacebinding verwijst naar de NCC. Goedkeuring aan resourcezijde is de laatste gate voordat de private-endpointregel bruikbaar wordt.
Terraform-resources
NCC
regionaal object
endpointregels
blob + dfs
workspace binding
dezelfde regio
Azure-goedkeuring
PENDING → ESTABLISHED
Provideropzet
NCC-resources zijn geen workspace-resources. Configureer een Databricks-provideralias voor de accountconsole en gebruik die alias voor alle drie NCC-resources.
Host: https://accounts.azuredatabricks.net
Een actuele gids voor Declarative Automation Bundles voor Databricks-projectstructuur, omgevingstargets, CI/CD en productiedeployment. uw Azure Databricks-account-ID
Authenticatie: gebruik Databricks unified authentication passend bij lokale of CI-uitvoering
terraform {
required_providers {
azurerm = {
source = "hashicorp/azurerm"
}
databricks = {
source = "databricks/databricks"
}
}
}
provider "azurerm" {
features {}
}
provider "databricks" {
alias = "accounts"
host = "https://accounts.azuredatabricks.net"
account_id = var.databricks_account_id
}
variable "databricks_account_id" { type = string }
variable "location" { type = string }
variable "workspace_id" { type = number }Implementatie
De resourcenamen hieronder behouden de drie Databricks-accountresources die door de bestaande implementatie worden gebruikt. Vervang de voorbeeldresource-referenties door je eigen workspace- en storageresources.
De NCC is regionaal. Gebruik dezelfde regio als de workspace die hem zal gebruiken.
resource "databricks_mws_network_connectivity_config" "ffa_titan_ncc" {
provider = databricks.accounts
name = "ffa-titan-ncc"
region = var.location
}Voor deze ADLS Gen2-implementatie maken we aparte regels voor de blob en dfs subresources.
resource "databricks_mws_ncc_private_endpoint_rule" "blob" {
provider = databricks.accounts
network_connectivity_config_id =
databricks_mws_network_connectivity_config.ffa_titan_ncc.network_connectivity_config_id
resource_id = azurerm_storage_account.ffa_titan_adls_gen2.id
group_id = "blob"
}resource "databricks_mws_ncc_private_endpoint_rule" "dfs" {
provider = databricks.accounts
network_connectivity_config_id =
databricks_mws_network_connectivity_config.ffa_titan_ncc.network_connectivity_config_id
resource_id = azurerm_storage_account.ffa_titan_adls_gen2.id
group_id = "dfs"
}De Azure-resource-eigenaar moet de private endpoint-connections nog steeds goedkeuren. Alleen de regels aanmaken maakt ze niet bruikbaar.
Als yield daalt, wil je niet alleen weten dát dit gebeurt maar ook waar het verlies ontstaat en wat het kost.
resource "databricks_mws_ncc_binding" "ffa_titan_ncc_binding" {
provider = databricks.accounts
network_connectivity_config_id =
databricks_mws_network_connectivity_config.ffa_titan_ncc.network_connectivity_config_id
workspace_id = var.workspace_id
}Goedkeuring gebeurt op de doel-Azure-resource. Voer dit in CI/CD uit met een Azure-identity die alleen de permissions heeft die nodig zijn om private-endpointverbindingen goed te keuren.
resource "terraform_data" "approve_storage_private_endpoints" {
triggers_replace = [
databricks_mws_ncc_private_endpoint_rule.blob.rule_id,
databricks_mws_ncc_private_endpoint_rule.dfs.rule_id
]
provisioner "local-exec" {
interpreter = ["bash", "-c"]
command = <<-EOT
for id in $(az network private-endpoint-connection list \
--id "${azurerm_storage_account.ffa_titan_adls_gen2.id}" \
--query "[?properties.privateLinkServiceConnectionState.status=='Pending'].id" \
-o tsv); do
az network private-endpoint-connection approve \
--id "$id" \
--description "Approved by FFA Titan Terraform"
done
EOT
}
}Approval-lifecycle
Een private-endpointregel maken stuurt een verzoek naar de doel-Azure-resource. Totdat dat verzoek is goedgekeurd kan de Databricks-regel geen productieverkeer dragen.
Regels die PENDING, REJECTED of DISCONNECTED blijven kunnen na 14 dagen verlopen, dus goedkeuring en validatie moeten onderdeel zijn van de deploymentworkflow.
Databricks provisiont het endpointrequest.
Wachten op goedkeuring van de Azure-resource.
Private endpoint is klaar voor serverless gebruik.
Databricks stelt dat de meeste wijzigingen aan private-endpointregels binnen 10 minuten propageren, maar dat volledige toepassing tot 24 uur kan duren. Herstart draaiende serverless-services na wijziging van de workspace-NCC-attachment.
Validatie
AI-ready datafundament
Validatievolgorde
Terraform state
NCC, blob rule, dfs rule and workspace binding exist.
Endpoint state
Private endpoint rules report ESTABLISHED.
Workspace attachment
The expected NCC is attached to the same-region workspace.
Serverless query
Run the real SQL query against the Unity Catalog object backed by ADLS Gen2.
Public-path test
Confirm the storage security posture still blocks paths that should not be public.
Verwachte uitkomst
Netwerk
Serverless verkeer bereikt het storage account via het goedgekeurde private endpoint.
Identiteit
Azure Storage-autorisatie blijft gescheiden van het private netwerkpad.
Governance
Unity Catalog-permissies bepalen nog steeds wie de externe data kan bevragen.
Veelgemaakte fouten
Vermijd
Using a workspace-level provider for NCC resources
Betere default
Use an account-level Databricks provider alias
Vermijd
Assuming endpoint creation equals approval
Betere default
Wait for ESTABLISHED before validating SQL
Vermijd
Binding multiple NCCs to one workspace
Betere default
Put all required private endpoint rules in one NCC
Vermijd
Treating private networking as data authorization
Betere default
Validate Azure RBAC and Unity Catalog separately
Vermijd
Hard-coding credentials in local-exec
Betere default
Run approval with your authenticated CI identity and least privilege
Vermijd
Testing only from classic compute
Betere default
Test from the serverless SQL workload this NCC is designed for
Hoe Food For Analytics dit implementeert
In Titan worden de NCC, destination rules en workspace attachment als infrastructure as code beheerd naast de Azure-resourcegrens. Validatie wordt uitgevoerd vanaf de serverless workload die de verbinding daadwerkelijk gebruikt.
Verken TitanTitan-netwerkdeployment
01
Declareer
NCC, rules en binding in Terraform.
02
Goedkeuren
Gecontroleerde goedkeuring aan Azure-resourcezijde.
03
Bewijzen
End-to-end serverless-queryvalidatie.
FAQ
Praktische antwoorden over Network Connectivity Configuration, Terraform, private endpoint rules en Serverless SQL-toegang tot Azure Data Lake Gen2.
Een NCC is een account-level regionale configuratie die serverless netwerkconnectiviteit beheert, inclusief private-endpointregels. Een NCC kan aan meerdere workspaces in dezelfde regio worden gekoppeld, maar iedere workspace kan slechts één actieve NCC-binding hebben.
De kernresources voor Databricks-account zijn databricks_mws_network_connectivity_config, databricks_mws_ncc_private_endpoint_rule en databricks_mws_ncc_binding.
Gebruik een account-level Databricks-provider. Voor Azure is de account-consolehost https://accounts.azuredatabricks.net en de provider moet het Databricks-account-ID kennen.
Het maakt een private endpoint rule aan binnen een NCC voor een doelresource. In Azure geeft u de Azure resource ID en de relevante subresource group ID op, zoals blob of dfs voor Azure Storage.
Nee. Een workspace kan één actieve NCC-binding hebben. Als de workspace meerdere private bestemmingen nodig heeft, voeg de benodigde private endpoint rules toe aan dezelfde NCC.
Nee. De eigenaar van de doel-Azure-resource moet de private endpoint-connection goedkeuren. De Databricks private endpoint rule wordt bruikbaar wanneer de connection state ESTABLISHED is.
Deze implementatie maakt aparte private endpoint rules voor de blob- en dfs-subresources van Azure Storage. Bevestig de exacte subresources die je workload nodig heeft voordat je het patroon standaardiseert.
Databricks-documentatie adviseert ongeveer 10 minuten te wachten na het koppelen van een NCC aan een workspace en draaiende serverless-services opnieuw te starten. Wijzigingen aan private-endpointregels propageren meestal snel, maar volledige propagatie kan langer duren.
Nee. VNet Injection is een classic-compute-networkingpatroon. NCC beheert outbound-connectiviteit vanuit de Azure Databricks serverless-compute-plane naar customer resources.
Nee. Netwerkbereikbaarheid, Azure-resourceautorisatie en Unity Catalog-privileges zijn afzonderlijke controls. Een ESTABLISHED-endpoint verleent geen storage- of catalogpermissions.
De huidige Azure Databricks-documentatie noemt maximaal 10 NCC's per regio per account, 100 private endpoints per regio over die NCC's en maximaal 50 workspaceattachments per NCC.
Implementatieondersteuning nodig?
We kunnen het NCC-ontwerp, de Terraform-graph, Azure-approvalflow en de omliggende Unity Catalog- en storagepermissies beoordelen.
Implementatiereview