Grupo de comandos policies

Note

El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.

El grupo de comandos policies dentro de la CLI de Databricks permite administrar directivas de Attribute-Based Access Control (ABAC) en el catálogo de Unity. ABAC proporciona una gobernanza de gran aprovechamiento para aplicar directivas de cumplimiento. Con las directivas de ABAC, el acceso se controla de forma jerárquica y escalable, en función de atributos de datos en lugar de recursos específicos. Para consultar las políticas de ABAC sobre un seguro, los llamantes deben tener el READ METADATA privilegio MANAGE o el privilegio sobre él, o ser propietarios. Para crear, actualizar o eliminar políticas, los llamantes deben tener MANAGE o poseer el seguro.

directivas de databricks create-policy

Cree una directiva de ABAC en un elemento protegible. La nueva directiva se aplica al elemento protegible y a todos sus descendientes.

databricks policies create-policy TO_PRINCIPALS FOR_SECURABLE_TYPE POLICY_TYPE [flags]

Argumentos

TO_PRINCIPALS

    Lista de nombres de usuario o grupo a los que se aplica la directiva.

FOR_SECURABLE_TYPE

    Tipo de elementos protegibles en los que debe surtir efecto la directiva. Valores admitidos: , , , CATALOGCLEAN_ROOM, , CONNECTIONCREDENTIALEXTERNAL_LOCATIONEXTERNAL_METADATAFUNCTIONMETASTOREPIPELINEPROVIDERRECIPIENTSCHEMASHARESTAGING_TABLESTORAGE_CREDENTIALTABLEVOLUME

POLICY_TYPE

    Tipo de la directiva. Valores admitidos: POLICY_TYPE_COLUMN_MASK, POLICY_TYPE_ROW_FILTER

Options

--comment string

    Descripción opcional de la directiva.

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--name string

    Nombre de la directiva.

--on-securable-fullname string

    Nombre completo del elemento protegible en el que se define la directiva.

--on-securable-type SecurableType

    Tipo de protegible en el que se define la directiva. Valores admitidos: , , , CATALOGCLEAN_ROOM, , CONNECTIONCREDENTIALEXTERNAL_LOCATIONEXTERNAL_METADATAFUNCTIONMETASTOREPIPELINEPROVIDERRECIPIENTSCHEMASHARESTAGING_TABLESTORAGE_CREDENTIALTABLEVOLUME

--when-condition string

    Condición opcional cuando la directiva debe surtir efecto.

Marcas globales

Examples

En el ejemplo siguiente se crea una directiva de filtro de fila:

databricks policies create-policy "data-engineers" TABLE POLICY_TYPE_ROW_FILTER --name "pii-filter" --on-securable-type TABLE --on-securable-fullname "main.default.customers"

Política de eliminación de políticas de Databricks

Elimine una directiva de ABAC definida en un elemento protegible.

databricks policies delete-policy ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME NAME [flags]

Argumentos

ON_SECURABLE_TYPE

    Obligatorio. Tipo del elemento protegible del que se va a eliminar la directiva.

ON_SECURABLE_FULLNAME

    Obligatorio. Nombre completo del elemento protegible del que se va a eliminar la directiva.

NAME

    Obligatorio. Nombre de la directiva que se va a eliminar.

Options

Marcas globales

Examples

En el ejemplo siguiente se elimina una directiva:

databricks policies delete-policy TABLE main.default.customers pii-filter

Políticas de Databricks Get-Policy

Obtenga la definición de directiva en un elemento protegible.

databricks policies get-policy ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME NAME [flags]

Argumentos

ON_SECURABLE_TYPE

    Obligatorio. Tipo del elemento protegible para el que recuperar la directiva.

ON_SECURABLE_FULLNAME

    Obligatorio. Nombre completo del elemento protegible para el que recuperar la directiva.

NAME

    Obligatorio. Nombre de la directiva que se va a recuperar.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtiene una directiva:

databricks policies get-policy TABLE main.default.customers pii-filter

Políticas de Databricks Lista-Políticas

Enumere todas las directivas definidas en un elemento protegible. Opcionalmente, la lista puede incluir directivas heredadas definidas en el catálogo o el esquema primario del elemento protegible.

databricks policies list-policies ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME [flags]

Argumentos

ON_SECURABLE_TYPE

    Obligatorio. Tipo del elemento protegible para el que se pueden enumerar las directivas.

ON_SECURABLE_FULLNAME

    Obligatorio. Nombre completo del elemento protegible para enumerar las directivas.

Options

--include-inherited

    Optional. Si se deben incluir directivas heredadas de elementos protegibles primarios.

--max-results int

    Optional. Número máximo de resultados que se van a devolver.

--page-token string

    Optional. Token de página de una llamada de lista anterior.

Marcas globales

Examples

En el ejemplo siguiente se enumeran las directivas de una tabla:

databricks policies list-policies TABLE main.default.customers

En el ejemplo siguiente se enumeran las directivas, incluidas las heredadas:

databricks policies list-policies TABLE main.default.customers --include-inherited

Política de actualización de políticas de Databricks

Actualice una directiva de ABAC en un elemento protegible.

databricks policies update-policy ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME NAME TO_PRINCIPALS FOR_SECURABLE_TYPE POLICY_TYPE [flags]

Argumentos

ON_SECURABLE_TYPE

    Obligatorio. Tipo del elemento protegible para el que se va a actualizar la directiva.

ON_SECURABLE_FULLNAME

    Obligatorio. Nombre completo del elemento protegible para el que actualizar la directiva.

NAME

    Obligatorio. Nombre de la directiva que se va a actualizar.

TO_PRINCIPALS

    Lista de nombres de usuario o grupo a los que se aplica la directiva.

FOR_SECURABLE_TYPE

    Tipo de elementos protegibles en los que debe surtir efecto la directiva. Valores admitidos: , , , CATALOGCLEAN_ROOM, , CONNECTIONCREDENTIALEXTERNAL_LOCATIONEXTERNAL_METADATAFUNCTIONMETASTOREPIPELINEPROVIDERRECIPIENTSCHEMASHARESTAGING_TABLESTORAGE_CREDENTIALTABLEVOLUME

POLICY_TYPE

    Tipo de la directiva. Valores admitidos: POLICY_TYPE_COLUMN_MASK, POLICY_TYPE_ROW_FILTER

Options

--comment string

    Descripción opcional de la directiva.

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--name string

    Nombre de la directiva.

--on-securable-fullname string

    Nombre completo del elemento protegible en el que se define la directiva.

--on-securable-type SecurableType

    Tipo de protegible en el que se define la directiva.

--update-mask string

    Optional. Máscara de campo que especifica qué campos se van a actualizar.

--when-condition string

    Condición opcional cuando la directiva debe surtir efecto.

Marcas globales

Examples

En el ejemplo siguiente se actualiza una directiva:

databricks policies update-policy TABLE main.default.customers pii-filter "data-engineers,data-scientists" TABLE POLICY_TYPE_ROW_FILTER

Marcas globales

--debug

  Indica si se va a habilitar el registro de depuración.

-h o --help

    Mostrar ayuda para la CLI de Databricks o el grupo de comandos relacionado o el comando relacionado.

--log-file cadena

    Cadena que representa el archivo en el que se van a escribir registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr.

--log-format formato

    Tipo de formato de registro: text o json. El valor predeterminado es text.

--log-level cadena

    Cadena que representa el nivel de formato de registro. Si no se especifica, el nivel de formato de registro está deshabilitado.

-o, --output tipo

    Tipo de salida del comando, text o json. El valor predeterminado es text.

-p, --profile cadena

    Nombre del perfil en el archivo ~/.databrickscfg que se usará para ejecutar el comando. Si no se especifica esta marca, si existe, se usa el perfil denominado DEFAULT .

--progress-format formato

    Formato para mostrar los registros de progreso: default, append, inplaceo json

-t, --target cadena

    Si procede, el destino del paquete que se va a usar