Skip to main content

external_users

Creates, updates, deletes, gets or lists an external_users resource.

Overview

Nameexternal_users
TypeResource
Iddatabricks_account.iamv2.external_users

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
namestringThe resource name of the external user. Format: accounts/{account_id}/external-users/{external_user_id}
account_idstringThe parent account ID, from Databricks.
external_user_idstringThe external ID of the user in the customer's IdP.
internal_idstringInternal userId of the user in Databricks.
display_namestringDisplay name of the user from the customer's IdP.
full_nameobjectThe full name of the user, from the customer's IdP.
account_user_statusstringThe activity status of the user in the Databricks account. (ACTIVE, INACTIVE)
usernamestringUsername/email of the user, from Databricks.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectnameRetrieves an external user with the given external ID from the customer's IdP. If the user does not

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
namestringRequired. The resource name of the external user. Format: accounts/{account_id}/external-users/{external_user_id}

SELECT examples

Retrieves an external user with the given external ID from the customer's IdP. If the user does not

SELECT
name,
account_id,
external_user_id,
internal_id,
display_name,
full_name,
account_user_status,
username
FROM databricks_account.iamv2.external_users
WHERE name = '{{ name }}' -- required
;