Skip to content

Commit 9ce2e6b

Browse files
authored
Add more Unity Catalog docs on Azure (#1179)
1 parent 9422eaa commit 9ce2e6b

File tree

6 files changed

+502
-23
lines changed

6 files changed

+502
-23
lines changed

docs/guides/unity-catalog.md renamed to docs/guides/unity-catalog-aws.md

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ page_title: "Unity Catalog set up on AWS"
44

55
# Deploying pre-requisite resources and enabling Unity Catalog (AWS Preview)
66

7-
-> **Private Preview** This feature is in [Private Preview](https://docs.databricks.com/release-notes/release-types.html). Contact your Databricks representative to request access.
7+
-> **Public Preview** This feature is in [Public Preview](https://docs.databricks.com/data-governance/unity-catalog/index.html). Contact your Databricks representative to request access.
88

99
Databricks Unity Catalog brings fine-grained governance and security to Lakehouse data using a familiar, open interface. You can use Terraform to deploy the underlying cloud resources and Unity Catalog objects automatically, using a programmatic approach.
1010

@@ -18,16 +18,14 @@ This guide uses the following variables in configurations:
1818
This guide is provided as-is and you can use this guide as the basis for your custom Terraform module.
1919

2020
To get started with Unity Catalog, this guide takes you throw the following high-level steps:
21-
- [Initialize the required providers](#provider-initialization)
22-
- [Configure AWS objects](#configure-aws-objects)
23-
- A S3 bucket to store data from managed tables in Unity Catalog
24-
- An IAM policy to define permissions to access data
25-
- An IAM role that will be assumed by Unity Catalog to access data
26-
- [Create users and groups who can access Unity Catalog](#create-users-and-groups)
27-
- [Create a Unity Catalog metastore and link it to workspaces](#create-a-unity-catalog-metastore)
28-
- [Create Unity Catalog objects in the metastore](#create-unity-catalog-objects)
29-
- [Configure external tables and credentials](#configure-external-tables)
30-
- [Configure Unity Catalog clusters](#configure-unity-catalog-clusters)
21+
- [Deploying pre-requisite resources and enabling Unity Catalog (AWS Preview)](#deploying-pre-requisite-resources-and-enabling-unity-catalog-aws-preview)
22+
- [Provider initialization](#provider-initialization)
23+
- [Configure AWS objects](#configure-aws-objects)
24+
- [Create users and groups](#create-users-and-groups)
25+
- [Create a Unity Catalog metastore and link it to workspaces](#create-a-unity-catalog-metastore-and-link-it-to-workspaces)
26+
- [Create Unity Catalog objects in the metastore](#create-unity-catalog-objects-in-the-metastore)
27+
- [Configure external tables and credentials](#configure-external-tables-and-credentials)
28+
- [Configure Unity Catalog clusters](#configure-unity-catalog-clusters)
3129

3230
## Provider initialization
3331

@@ -416,7 +414,7 @@ resource "aws_iam_role" "external_data_access" {
416414
}
417415
```
418416

419-
Then create the [databricks_storage_credential](../resources/storage_credential.md) and [databricks_external_location](../resources/xternal_location.md) in Unity Catalog.
417+
Then create the [databricks_storage_credential](../resources/storage_credential.md) and [databricks_external_location](../resources/external_location.md) in Unity Catalog.
420418

421419
```hcl
422420
resource "databricks_storage_credential" "external" {
@@ -485,8 +483,8 @@ resource "databricks_cluster" "unity_sql" {
485483
}
486484
```
487485

488-
- To use those advanced cluster features or languages like Python, Scala and R with Unity Catalog, one must choose **Single User** Mode when launching the cluster. The cluster can only be used exclusively by a single user (by default the owner of the cluster); other users are not allowed to attach to the cluster.
489-
This means a group of users, which is managed as a group through SCIM provisioning, will be a collection of single-user [databricks_cluster](../resources/cluster.md), which they should be able to restart. Terraform's `for_each` meta-attribute helps to do this easily.
486+
- To use those advanced cluster features or languages like Python, Scala and R with Unity Catalog, one must choose **Single User** mode when launching the cluster. The cluster can only be used exclusively by a single user (by default the owner of the cluster); other users are not allowed to attach to the cluster.
487+
The below example will create a collection of single-user [databricks_cluster](../resources/cluster.md) for each user in a group managed through SCIM provisioning. Individual user will be able to restart their cluster, but not anyone else. Terraform's `for_each` meta-attribute will help us achieve this.
490488

491489
First we use [databricks_group](../data-sources/group.md) and [databricks_user](../data-sources/user.md) data resources to get the list of user names, that belong to a group.
492490

0 commit comments

Comments
 (0)