Skip to content

Commit 2bebaa1

Browse files
authored
[Doc] Add warning about disabling legacy features and default catalog (#4905)
## Changes <!-- Summary of your changes that are easy to understand --> ## Tests <!-- How is this tested? Please see the checklist below and also describe any other relevant tests --> - [x] relevant change in `docs/` folder - [x] has entry in `NEXT_CHANGELOG.md` file
1 parent cc529f2 commit 2bebaa1

File tree

2 files changed

+12
-0
lines changed

2 files changed

+12
-0
lines changed

NEXT_CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@
3434
* Improve docs for `databricks_compliance_security_profile_setting` ([#4880](https://github.com/databricks/terraform-provider-databricks/pull/4880)).
3535
* Improve instructions for the Terraform Exporter ([#4892](https://github.com/databricks/terraform-provider-databricks/pull/4892)).
3636
* Improve documentation for service principal data sources ([#4900](https://github.com/databricks/terraform-provider-databricks/pull/4900)).
37+
* Add warning about disabling legacy features and default catalog ([#4905](https://github.com/databricks/terraform-provider-databricks/pull/4905)).
3738
* Improve documentation for grants resources ([#4906](https://github.com/databricks/terraform-provider-databricks/pull/4906))
3839

3940
### Exporter

docs/resources/disable_legacy_features_setting.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,10 @@ subcategory: "Settings"
88

99
The `databricks_disable_legacy_features_setting` resource allows you to disable legacy features on newly created workspaces.
1010

11+
~> Before disabling legacy features, make sure that default catalog for the workspace is set to value different than `hive_metastore`! You can set it using the [databricks_default_namespace_setting](default_namespace_setting.md) resource.
12+
1113
When this setting is on, the following applies to new workspaces:
14+
1215
- Disables the use of DBFS root and mounts.
1316
- Hive Metastore will not be provisioned.
1417
- Disables the use of 'No-isolation clusters'.
@@ -17,6 +20,14 @@ When this setting is on, the following applies to new workspaces:
1720
## Example Usage
1821

1922
```hcl
23+
# Change default catalog to anything than `hive_metastore`
24+
resource "databricks_default_namespace_setting" "this" {
25+
namespace {
26+
value = "default_catalog"
27+
}
28+
}
29+
30+
# Disable legacy features
2031
resource "databricks_disable_legacy_features_setting" "this" {
2132
disable_legacy_features {
2233
value = true

0 commit comments

Comments
 (0)