Skip to main content

account_user_preferences

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

Overview​

Nameaccount_user_preferences
TypeResource
Iddatabricks_account.settingsv2.account_user_preferences

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
namestringName of the setting.
user_idstringUser ID of the user.
â–¶boolean_valobject
â–¶effective_boolean_valobject
â–¶effective_string_valobject
â–¶string_valobject

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_public_account_user_preferenceselectaccount_id, user_id, name, account_hostGet a user preference for a specific user. User preferences are personal settings that allow
patch_public_account_user_preferenceupdateaccount_id, user_id, name, account_hostUpdate a user preference for a specific user. User preferences are personal settings that allow

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
account_hoststringThe Databricks account console host. Selected by DATABRICKS_CLOUD (aws, azure or gcp; default aws), or set explicitly with DATABRICKS_ACCOUNT_HOST (bare host, no scheme). (default: accounts.cloud.databricks.com, x-stackQL-envVar: DATABRICKS_ACCOUNT_HOST, x-stackQL-envVarSelector: {"envVar":"DATABRICKS_CLOUD","default":"aws","values":{"aws":"accounts.cloud.databricks.com","azure":"accounts.azuredatabricks.net","gcp":"accounts.gcp.databricks.com"}})
account_idstring
namestring
user_idstringUser ID of the user whose setting is being updated.

SELECT examples​

Get a user preference for a specific user. User preferences are personal settings that allow

SELECT
name,
user_id,
boolean_val,
effective_boolean_val,
effective_string_val,
string_val
FROM databricks_account.settingsv2.account_user_preferences
WHERE account_id = '{{ account_id }}' -- required
AND user_id = '{{ user_id }}' -- required
AND name = '{{ name }}' -- required
AND account_host = '{{ account_host }}' -- required
;

UPDATE examples​

Update a user preference for a specific user. User preferences are personal settings that allow

UPDATE databricks_account.settingsv2.account_user_preferences
SET
boolean_val = '{{ boolean_val }}',
effective_boolean_val = '{{ effective_boolean_val }}',
effective_string_val = '{{ effective_string_val }}',
name = '{{ name }}',
string_val = '{{ string_val }}',
user_id = '{{ user_id }}'
WHERE
account_id = '{{ account_id }}' --required
AND user_id = '{{ user_id }}' --required
AND name = '{{ name }}' --required
AND account_host = '{{ account_host }}' --required
RETURNING
name,
user_id,
boolean_val,
effective_boolean_val,
effective_string_val,
string_val;