Various doc updates (#1553)

* update current user doc
* fix owner field in UC docs

Author: nkvuong

docs/data-sources/current_user.md

@@ -5,7 +5,7 @@ subcategory: "Security"
 
 -> **Note** If you have a fully automated setup with workspaces created by [databricks_mws_workspaces](../resources/mws_workspaces.md) or [azurerm_databricks_workspace](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/databricks_workspace), please make sure to add [depends_on attribute](../index.md#data-resources-and-authentication-is-not-configured-errors) in order to prevent _authentication is not configured for provider_ errors.
 
-Retrieves information about [databricks_user](../resources/user.md) or [databricks_service_principal](../resources/service_principal.md), that is calling Databricks REST API. Might be useful in applying the same Terraform by different users in the shared workspace for testing purposes. 
+Retrieves information about [databricks_user](../resources/user.md) or [databricks_service_principal](../resources/service_principal.md), that is calling Databricks REST API. Might be useful in applying the same Terraform by different users in the shared workspace for testing purposes.
 
 ## Example Usage
 
@@ -56,15 +56,13 @@ output "job_url" {
 Data source exposes the following attributes:
 
 * `id` -  The id of the calling user.
-* `application_id` - Application ID of the [service principal](../resources/service_principal.md) if the currently logged-in user is a service principal, e.g. `11111111-2222-3333-4444-555666777888`
 * `external_id` - ID of the user in an external identity provider.
-* `user_name` - Name of the [user](../resources/user.md), e.g. `[email protected]`.
+* `user_name` - Name of the [user](../resources/user.md), e.g. `[email protected]`. If the currently logged-in identity is a [service principal](../resources/service_principal.md), returns the application ID, e.g. `11111111-2222-3333-4444-555666777888`
 * `home` - Home folder of the [user](../resources/user.md), e.g. `/Users/[email protected]`.
 * `repos` - Personal Repos location of the [user](../resources/user.md), e.g. `/Repos/[email protected]`.
 * `alphanumeric` - Alphanumeric representation of user local name. e.g. `mr_foo`.
 * `workspace_url` - URL of the current Databricks workspace.
 
-
 ## Related Resources
 
 The following resources are used in the same context:

docs/resources/catalog.md

@@ -27,7 +27,7 @@ resource "databricks_catalog" "sandbox" {
 The following arguments are required:
 
 * `name` - Name of Catalog relative to parent metastore. Change forces creation of a new resource.
-* `owner` - (Optional) Username/groupname/sp application_id catalog owner.
+* `owner` - (Optional) Username/groupname/sp application_id of the catalog owner.
 * `comment` - (Optional) User-supplied free-form text.
 * `properties` - (Optional) Extensible Catalog properties.
 

docs/resources/external_location.md

@@ -3,11 +3,12 @@ subcategory: "Unity Catalog"
 ---
 # databricks_external_location Resource
 
--> **Public Preview** This feature is in [Public Preview](https://docs.databricks.com/release-notes/release-types.html). Contact your Databricks representative to request access. 
+-> **Public Preview** This feature is in [Public Preview](https://docs.databricks.com/release-notes/release-types.html). Contact your Databricks representative to request access.
 
 To work with external tables, Unity Catalog introduces two new objects to access and work with external cloud storage:
+
 - [databricks_storage_credential](storage_credential.md) represent authentication methods to access cloud storage (e.g. an IAM role for Amazon S3 or a service principal for Azure Storage). Storage credentials are access-controlled to determine which users can use the credential.
-- `databricks_external_location` are objects that combine a cloud storage path with a Storage Credential that can be used to access the location. 
+- `databricks_external_location` are objects that combine a cloud storage path with a Storage Credential that can be used to access the location.
 
 ## Example Usage
 
@@ -79,17 +80,17 @@ resource "databricks_grants" "some" {
 
 The following arguments are required:
 
-* `name` - Name of External Location, which must be unique within the [databricks_metastore](metastore.md). Change forces creation of a new resource.
-* `url` - Path URL in cloud storage, of the form: `s3://[bucket-host]/[bucket-dir]` (AWS), `abfss://[user]@[host]/[path]` (Azure).
-* `credential_name` - Name of the [databricks_storage_credential](storage_credential.md) to use with this External Location.
-* `owner` - (Optional) Username/groupname/sp application_id External Location owner.
-* `comment` - (Optional) User-supplied free-form text.
-* `skip_validation` - (Optional) Suppress validation errors if any & force save the external location
+- `name` - Name of External Location, which must be unique within the [databricks_metastore](metastore.md). Change forces creation of a new resource.
+- `url` - Path URL in cloud storage, of the form: `s3://[bucket-host]/[bucket-dir]` (AWS), `abfss://[user]@[host]/[path]` (Azure).
+- `credential_name` - Name of the [databricks_storage_credential](storage_credential.md) to use with this External Location.
+- `owner` - (Optional) Username/groupname/sp application_id of the external Location owner.
+- `comment` - (Optional) User-supplied free-form text.
+- `skip_validation` - (Optional) Suppress validation errors if any & force save the external location
 
 ## Import
 
 This resource can be imported by name:
 
 ```bash
-$ terraform import databricks_external_location.this <name>
+terraform import databricks_external_location.this <name>
 ```

docs/resources/metastore.md

@@ -51,7 +51,7 @@ The following arguments are required:
 
 * `name` - Name of metastore.
 * `storage_root` - Path on cloud storage account, where managed [databricks_table](table.md) are stored. Change forces creation of a new resource.
-* `owner` - (Optional) Username/groupname/sp application_id Metastore owner.
+* `owner` - (Optional) Username/groupname/sp application_id of the metastore owner.
 * `delta_sharing_scope` - (Optional) Required along with `delta_sharing_recipient_token_lifetime_in_seconds`. Used to enable delta sharing on the metastore. Valid values: INTERNAL, INTERNAL_AND_EXTERNAL.
 * `delta_sharing_recipient_token_lifetime_in_seconds` - (Optional) Required along with `delta_sharing_scope`. Used to set expiration duration in seconds on recipient data access tokens. Set to 0 for unlimited duration.
 * `delta_sharing_organization_name` - (Optional) The organization name of a Delta Sharing entity. This field is used for Databricks to Databricks sharing. Once this is set it cannot be removed and can only be modified to another valid value. To delete this value please taint and recreate the resource.

docs/resources/schema.md

@@ -37,7 +37,7 @@ The following arguments are required:
 
 * `name` - Name of Schema relative to parent catalog. Change forces creation of a new resource.
 * `catalog_name` - Name of parent catalog
-* `owner` - (Optional) Username/groupname/sp application_id schema owner.
+* `owner` - (Optional) Username/groupname/sp application_id of the schema owner.
 * `comment` - (Optional) User-supplied free-form text.
 * `properties` - (Optional) Extensible Schema properties.
 

docs/resources/storage_credential.md

@@ -78,6 +78,8 @@ resource "databricks_grants" "external_creds" {
 The following arguments are required:
 
 - `name` - Name of Storage Credentials, which must be unique within the [databricks_metastore](metastore.md). Change forces creation of a new resource.
+- `owner` - (Optional) Username/groupname/sp application_id of the storage credential owner.
+
 
 `aws_iam_role` optional configuration block for credential details for AWS:
 

docs/resources/table.md

@@ -69,7 +69,7 @@ The following arguments are required:
 * `data_source_format` - External tables are supported in multiple data source formats. The string constants identifying these formats are `DELTA`, `CSV`, `JSON`, `AVRO`, `PARQUET`, `ORC`, `TEXT`
 * `view_definition` - (Optional) SQL text defining the view (for `table_type == "VIEW"`)
 * `storage_credential_name` - (Optional) For EXTERNAL Tables only: the name of storage credential to use. This cannot be updated
-* `owner` - (Optional) Username/groupname/sp application_id Table owner.
+* `owner` - (Optional) Username/groupname/sp application_id of the table owner.
 * `comment` - (Optional) User-supplied free-form text.
 * `properties` - (Optional) Extensible Table properties.