Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las políticas de computación sin servidor permiten a los administradores de espacios de trabajo controlar el acceso a los productos de computación sin servidor compatibles, limitar su configuración y aplicar etiquetas en los recursos de computación recién creados. Esta página explica cómo crear políticas, conceder acceso y utilizarlas con Lakebase.
Importante
Las políticas de computación sin servidor están en la Vista previa privada y se gestionan a través de la API REST. La vista previa admite Lakebase. Póngase en contacto con el equipo de la cuenta de Databricks para solicitar acceso.
Requirements
- Tu espacio de trabajo debe estar inscrito en la vista previa de políticas de computación sin servidor y tener acceso a Lakebase. Consulta Disponibilidad por región para la disponibilidad de la región Lakebase.
- Debes ser administrador de espacio de trabajo para crear una política. Para leer o utilizar una política existente, necesitas
CAN_USEoCAN_MANAGEen esa política. Para actualizar o eliminar una política personalizada, o gestionar los permisos de una política, necesitasCAN_MANAGE. - Los ejemplos usan
curl,jq, y un token OAuth de espacio de trabajo. El ejemplo de autenticación utiliza la CLI de Databricks.
Cómo funcionan las políticas de computación sin servidor
Una política de computación sin servidor pertenece a un espacio de trabajo. Su allowed_compute_products objeto especifica qué productos de cómputo puede utilizar un usuario a través de la política y los límites de la configuración de cada producto. Otorgue acceso a una política para permitir que los usuarios utilicen los productos que la política permite dentro de esos límites.
Tras la creación, la política adjunta regula los cambios en la configuración del cómputo mientras la política existe. Endurecer una política no cambia el recurso de cómputo existente. Las actualizaciones posteriores de la configuración regida por la política deben cumplir sus restricciones actuales. Por ejemplo, un cambio de capacidad en Lakebase debe ajustarse dentro del máximo actual de la política, medido en unidades de cálculo (CU).
Para políticas que controlan el cómputo clásico, consulte Crear y gestionar políticas de cómputo clásicas.
Permisos para cambios de configuración
Actualizar la configuración de un recurso o reemplazar su política de cálculo requiere los siguientes permisos:
| Cambio en la configuración | Permisos necesarios |
|---|---|
| Cambiar configuraciones fuera del ámbito de aplicación de la política | Permiso para gestionar el recurso. No se requiere permiso para usar la política. |
| Cambiar la configuración de cálculo regida por la política | Permiso para gestionar el recurso y CAN_USE o CAN_MANAGE en la política, incluso si no establece ningún límite para la configuración. |
| Sustituya la política adjunta | Permiso para gestionar el recurso y CAN_USE o CAN_MANAGE tanto en la política actual como en la de reemplazo. |
El permiso para gestionar un recurso depende del producto. Por ejemplo, un usuario en CAN_MANAGE un proyecto Lakebase puede cambiar su nombre de visualización sin acceso a su política de cálculo. Cambiar la capacidad de cálculo o la configuración de escala a cero requiere permiso para usar la política, incluso cuando la política no establece límites de capacidad o de tiempo inactivo.
El permiso para usar una política no elude sus restricciones. Las configuraciones actualizadas deben cumplir los límites de la política y preservar sus pares clave-valor de etiqueta requeridos.
No puedes eliminar una política de un recurso sin asignar una política de reemplazo. Para un proyecto Lakebase, la política de reemplazo debe permitir Lakebase. Borrar spec.compute_policy_id asigna la Política Predeterminada de Lakebase como reemplazo y requiere los mismos permisos.
Etiquetas de política
Utilice el mapa opcional de nivel superior tags para especificar etiquetas de clave-valor, junto con display_name y allowed_compute_products. Las claves de etiqueta y los valores son cadenas. Una política puede tener hasta 20 etiquetas, y cada clave no debe estar vacía.
Las etiquetas de una política de cómputo sin servidor se propagan a los recursos de cómputo creados con esa política. La política hace cumplir estas etiquetas mientras la política existe y permanece adherida. Los cambios en las etiquetas del cómputo deben preservar los pares clave-valor requeridos por la política adjunta.
Las políticas de uso sin servidor, también llamadas políticas presupuestarias sin servidor, asignan etiquetas para la atribución de costes y utilizan un ID de política separado. Puede utilizar una política de uso sin servidor junto con una política de cómputo sin servidor. El cómputo creado recibe la unión de las etiquetas de ambas políticas. Por ejemplo, si la política de cómputo especifica environment=development y la política de uso especifica cost_center=engineering, el cómputo recibe ambas etiquetas.
Configuraciones de políticas de Lakebase
Para permitir Lakebase mediante una política de computación sin servidor, incluye lakebase en allowed_compute_products.
Creación de proyectos de Lakebase
Crear un proyecto Lakebase requiere CAN_USE o CAN_MANAGE en una política que permita Lakebase. Cuando creas un proyecto de Lakebase, recibes automáticamente CAN_MANAGE sobre él.
Los permisos de política no conceden acceso a proyectos Lakebase existentes ni a sus datos. Los permisos de proyecto Lakebase controlan la gestión de recursos, con permisos adicionales de política necesarios para cambiar la configuración de cálculo regida por una política. Los roles y privilegios de Postgres controlan el acceso a la base de datos.
Límites de capacidad y tiempo de inactividad
Configure uno o ambos de los siguientes campos en allowed_compute_products.lakebase:
| Field | Description |
|---|---|
max_capacity_units_per_instance |
Capacidad máxima en Lakebase CU. Para un cálculo con autoescalado, el máximo configurado debe ajustarse a este límite. |
max_idle_minutes_before_scale_to_zero |
Tiempo máximo de inactividad, en minutos, antes de que el compute escale a cero. Un recurso de proceso sujeto a este límite debe tener habilitado el escalado a cero, con un tiempo de espera igual o inferior al límite. |
Ambos campos aceptan enteros positivos. Omitir un campo no establece un límite de política para esa configuración. Un objeto vacío lakebase permite Lakebase sin ninguno de los dos límites. Una política debe incluir un objeto lakebase para permitir Lakebase.
Por ejemplo, el siguiente lakebase objeto limita cada cálculo a 16 CU y requiere escalar a cero tras como máximo 15 minutos de inactividad:
{
"max_capacity_units_per_instance": 16,
"max_idle_minutes_before_scale_to_zero": 15
}
Estos límites complementan los tamaños de cálculo compatibles y la configuración de escala a cero. Una política no pone a disposición una configuración no soportada. Consulte Limitaciones para configuraciones que no pueden usar escalado a cero.
Política predeterminada de Lakebase
La Política Predeterminada de Lakebase del espacio de trabajo permite Lakebase sin límites de capacidad ni de tiempo ocioso. Los usuarios del espacio de trabajo pueden usar esta política para crear proyectos Lakebase por defecto.
Los administradores del espacio de trabajo pueden conceder o revocar permisos sobre la Política predeterminada de Lakebase a través de la API de Permisos. No pueden eliminar la política ni cambiar su nombre o configuración.
Cuando creas un proyecto Lakebase sin especificar una política de cálculo, la solicitud utiliza la Política Predeterminada de Lakebase. Debes tener permiso para usar esa política. Crear una política personalizada no revoca el acceso a la política predeterminada ni aplica automáticamente la política personalizada a proyectos Lakebase existentes. Para exigir a los usuarios que seleccionen una política personalizada, consulte Exigir una política personalizada para la creación de proyectos en Lakebase.
Configurar la autenticación por API
Utilice la URL de su espacio de trabajo y un token OAuth del espacio de trabajo para estas solicitudes. Consulte Autorizar el acceso de usuarios a Azure Databricks con OAuth para detalles de autenticación.
Configura
WORKSPACEen la URL de tu espacio de trabajo, sin una barra diagonal final:export WORKSPACE="https://<workspace-host>"Autentíquese en ese espacio de trabajo:
databricks auth login --host "$WORKSPACE"Recuperar un token OAuth para la identidad autenticada:
export DATABRICKS_TOKEN="$(databricks auth token --host "$WORKSPACE" | jq -r .access_token)"
Actualice el token si expira. Ejecuta cada solicitud como una identidad con los permisos necesarios.
Crear una política
El siguiente ejemplo crea una política de computación sin servidor que permite a Lakebase:
Como administrador de espacio de trabajo, envía la siguiente solicitud. Crea una política con un máximo de 16 CU, un tiempo de espera máximo de inactividad de 15 minutos y una
environment=developmentetiqueta obligatoria:curl --fail-with-body -sS -X POST "$WORKSPACE/api/2.0/policies/compute" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "display_name": "Lakebase development", "allowed_compute_products": { "lakebase": { "max_capacity_units_per_instance": 16, "max_idle_minutes_before_scale_to_zero": 15 } }, "tags": { "environment": "development" } }'Copia el
compute_policy_idde la respuesta y configúralo para solicitudes posteriores:export COMPUTE_POLICY_ID="<compute-policy-id>"Recupere la política para verificar su nombre y las restricciones del producto. Esta respuesta no incluye las etiquetas de la política:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
El cuerpo de la solicitud es el propio objeto de política. El servicio asigna compute_policy_id. Elige un nombre de visualización único en el espacio de trabajo, de 1 a 127 caracteres.
Conceder acceso a una política
Utilice la API de Permisos con el tipo compute-policyde objeto . El creador de la política tiene CAN_MANAGE.
Como identidad con
CAN_MANAGE, concede permiso a un grupo de espacio de trabajo existente para usar la política. Sustituyelakebase-developerspor el nombre de tu grupo:curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/permissions/compute-policy/$COMPUTE_POLICY_ID" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "access_control_list": [ { "group_name": "lakebase-developers", "permission_level": "CAN_USE" } ] }'Verifique el permiso:
curl --fail-with-body -sS \ "$WORKSPACE/api/2.0/permissions/compute-policy/$COMPUTE_POLICY_ID" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
Use user_name para conceder acceso a un usuario, o service_principal_name con el ID de aplicación de una entidad de servicio. Concede CAN_MANAGE para permitir que un principal utilice la política y gestione sus permisos. Para políticas personalizadas, CAN_MANAGE también permite actualizar la configuración y eliminar la política.
PATCH actualiza los permisos especificados.
PUT reemplaza las asignaciones directas de permisos, así que incluye el conjunto completo que planeas conservar.
Requerir una política personalizada para la creación de proyectos en Lakebase
Como administrador de espacio de trabajo, utilice los siguientes pasos para exigir a los usuarios que seleccionen una directiva personalizada:
-
Lista de políticas, siguiendo los valores de
next_page_token. Encuentra la Política predeterminada de Lakebase por su valoris_defaulty entradalakebaseenallowed_compute_products. Cópialocompute_policy_id. - Conceda a los usuarios o grupos afectados acceso a una política personalizada que permita Lakebase.
- Para proyectos Lakebase existentes que usan la política predeterminada, sustituya su política si los usuarios necesitan seguir cambiando la configuración de computación gobernada. Revocar el acceso a la política predeterminada evita esos cambios en el cómputo que aún la utiliza.
- Recupere los permisos de la política predeterminada con
GET /api/2.0/permissions/compute-policy/<default-policy-id>. Revisa tanto los permisos concedidos a usuarios como a grupos. La política predeterminada concede inicialmente acceso alusersgrupo, por lo que eliminar una concesión directa de usuario por sí sola no elimina el acceso de ese usuario. -
Sustituya las asignaciones directas de permisos por
PUT /api/2.0/permissions/compute-policy/<default-policy-id>. Incluye las subvenciones directas que pretendes conservar enaccess_control_list, y omite las subvenciones que den acceso a los usuarios afectados. Sustituya la concesión generaluserspor concesiones a grupos específicos si algunos usuarios deben conservar el acceso a la directiva predeterminada. Cada entrada de solicitud utiliza un nombre principal ypermission_level, como en el ejemplo del permiso. No envíe la respuesta de permisos GET sin cambios como el cuerpo PUT. - Como usuario afectado, vuelve a listar las políticas. Verifique que la política personalizada esté disponible y que la política predeterminada ya no esté disponible. El usuario debe ahora especificar un ID de política personalizado al crear un proyecto Lakebase.
Utilice una política con proyectos Lakebase
Utilice la API de Postgres (/api/2.0/postgres/) para crear y gestionar proyectos de Lakebase. Un proyecto Lakebase contiene ramas, y los endpoints de computación proporcionan computación para esas ramas. Consulta Computes y endpoints.
Seleccione una política de cómputo con spec.compute_policy_id cuando cree un proyecto Lakebase. La política adjunta regula la configuración de cómputo y aplica sus etiquetas requeridas en el cómputo asociado. La gestión de políticas utiliza la /api/2.0/policies/compute API separada.
Crear un proyecto Lakebase con una política
Utilice una identidad con CAN_USE o CAN_MANAGE en la política creada arriba:
Crea un proyecto Lakebase con un rango de autoescalado de 2–8 CU y un tiempo de espera de inactividad de 15 minutos:
curl --fail-with-body -sS -X POST \ "$WORKSPACE/api/2.0/postgres/projects?project_id=policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d "$(jq -n --arg policy_id "$COMPUTE_POLICY_ID" '{ "spec": { "display_name": "Policy example", "compute_policy_id": $policy_id, "default_endpoint_settings": { "autoscaling_limit_min_cu": 2, "autoscaling_limit_max_cu": 8, "suspend_timeout_duration": "900s" } } }')"Los valores de capacidad son Lakebase CU. El máximo de 8 CU cumple con el límite de 16 CU establecido por la directiva. Lakebase expresa el tiempo de espera de inactividad como una duración en segundos:
"900s"es igual al límite de 15 minutos de la política. Estos valores predeterminados configuran el cómputo inicial y proporcionan la configuración inicial para los nuevos cómputos en el proyecto Lakebase.Para aplicar también una política de uso sin servidor, añade
"budget_policy_id": "<usage-policy-id>"insidespec, usando el ID de una política que puedas utilizar. Compute recibe etiquetas de ambas políticas.Copie la operación
namedesde la respuesta y configurela para la solicitud de estado:export OPERATION_NAME="<operation-name>"Recupere la operación hasta que
doneseatrue:curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/$OPERATION_NAME" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Si la respuesta contiene
error, resólvela antes de continuar. Las solicitudes de creación, actualización y eliminación utilizan este patrón de operación de larga duración.
Lee y lista proyectos de Lakebase
Recuperar el proyecto Lakebase:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects/policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Comprueba que coincida
status.compute_policy_idcon la política que seleccionaste.Enumera los proyectos de Lakebase a los que puedes acceder:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
Si la respuesta de la lista incluye next_page_token, pasa ese valor como page_token para recuperar la siguiente página.
Actualizar un proyecto de Lakebase
Usa una identidad con CAN_MANAGE en el proyecto Lakebase. Cambiar su nombre de visualización no requiere permiso para usar su política de cálculo.
Actualiza el nombre de visualización del proyecto Lakebase, especificando el campo en la máscara de actualización:
curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/postgres/projects/policy-example?update_mask=spec.display_name" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"spec": {"display_name": "Lakebase development"}}'Espere a que se complete la operación devuelta y luego recupere el proyecto Lakebase para verificar el cambio.
Cambiar la capacidad de un proyecto Lakebase o los valores predeterminados de computación con escalado a cero también requiere CAN_USE o CAN_MANAGE en la política, incluso si no establece ningún límite para la configuración. Los nuevos valores deben cumplir los límites de la política aplicables. Los valores predeterminados se aplican cuando se crean nuevas instancias. Para modificar una instancia de procesamiento existente, actualice su endpoint como se muestra en el siguiente procedimiento.
Para cambiar la política adjunta, consulte Reemplazar la política de un proyecto Lakebase.
Actualizar instancia de cómputo de Lakebase
El siguiente ejemplo eleva el máximo de computación existente a 16 CU y acorta su tiempo de espera de inactividad a 10 minutos. Necesitas CAN_MANAGE en el proyecto Lakebase y CAN_USE o CAN_MANAGE en la política:
Enumera los puntos finales en la rama del
productionproyecto Lakebase:curl --fail-with-body -sS \ "$WORKSPACE/api/2.0/postgres/projects/policy-example/branches/production/endpoints" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Copie el endpoint
namedel cómputo inicial desde la respuesta. El nombre incluye el proyecto Lakebase, la rama y la ruta de endpoint:export ENDPOINT_NAME="<endpoint-name>"Actualice la CU máxima y la configuración de escalado a cero. Úsase
spec.suspensionen la máscara de actualización para el tiempo de espera de inactividad:curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/postgres/$ENDPOINT_NAME?update_mask=spec.autoscaling_limit_max_cu,spec.suspension" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "spec": { "autoscaling_limit_max_cu": 16, "suspend_timeout_duration": "600s" } }'Espere a que se complete la operación devuelta y luego recupere el punto final:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/$ENDPOINT_NAME" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Verifique
status.autoscaling_limit_max_cuystatus.suspend_timeout_duration.
El máximo actualizado se ajusta al límite de 16 CU de la política y "600s" está por debajo de su límite de inactividad de 15 minutos. Para este cálculo, las solicitudes superiores a 16 CU, los tiempos de espera de inactividad superiores a 15 minutos o la desactivación de la configuración de escala a cero no superan la validación de la política. Elige configuraciones dentro de los límites de la política o pide a un gestor de políticas que las revise.
Sustituir la política de un proyecto Lakebase
Necesitas CAN_MANAGE en el proyecto Lakebase y CAN_USE o CAN_MANAGE en la política actual y en su sustitución. El reemplazo debe permitir Lakebase.
Cambiar de política es una actualización de configuración. Los valores predeterminados de computación y computación existentes del proyecto Lakebase deben cumplir las restricciones de la política de reemplazo antes de que la actualización pueda completarse.
Seleccione una política de reemplazo y fije su ID:
export REPLACEMENT_COMPUTE_POLICY_ID="<replacement-policy-id>"Verifique que los valores predeterminados de cómputo del proyecto Lakebase y los recursos de cómputo existentes cumplan con los límites de capacidad y tiempo de inactividad de la política de reemplazo. Actualice el cómputo existente y ajuste los valores predeterminados si es necesario.
Actualice la asignación de políticas del proyecto Lakebase:
curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/postgres/projects/policy-example?update_mask=spec.compute_policy_id" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d "$(jq -n --arg policy_id "$REPLACEMENT_COMPUTE_POLICY_ID" '{ "spec": { "compute_policy_id": $policy_id } }')"Espere a que la operación devuelta termine con
done: true. Si contiene unerror, resólvelo antes de continuar.Recupere el proyecto Lakebase y verifique que
status.compute_policy_idcoincida con el ID de política de reemplazo:curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects/policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
Borrar spec.compute_policy_id selecciona la Política predeterminada de Lakebase y requiere permiso para usarla. No deja al proyecto Lakebase sin una política.
Eliminar un proyecto de Lakebase
Por defecto, eliminar un proyecto Lakebase lo hace indisponible y lo conserva para su recuperación durante el periodo de retención. Eliminar un proyecto de Lakebase no elimina la directiva del espacio de trabajo.
Elimine el proyecto de ejemplo de Lakebase:
curl --fail-with-body -sS -X DELETE \ "$WORKSPACE/api/2.0/postgres/projects/policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Espere a que se complete la operación devuelta. Para los requisitos de eliminación, incluidas las ramas protegidas, consulte Eliminar un proyecto.
Administrar directivas
Utilice las siguientes operaciones para inspeccionar y mantener las políticas en su espacio de trabajo.
Obtener y listar políticas
Obtén una política individual con GET /api/2.0/policies/compute/{compute_policy_id}, como se muestra en Crear una política. Para listar las políticas que puede usar o gestionar, ejecute:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/policies/compute?page_size=100" \
-H "Authorization: Bearer $DATABRICKS_TOKEN"
La respuesta contiene compute_policies y, cuando haya más resultados disponibles, next_page_token. Pasa ese token como page_token en la siguiente petición. El tamaño de página predeterminado es 100 y el máximo es 150. Los resultados no están ordenados. Cada política incluye can_use y can_manage para la identidad que llama.
is_default identifica una política predeterminada.
Actualizar una directiva
Las actualizaciones de políticas requieren un parámetro de consulta update_mask. Los caminos soportados son display_name y allowed_compute_products. Para actualizar ambos, separa las rutas con una coma. Este endpoint no admite actualizar tags.
Recupere la política y revise la configuración que pretende conservar.
Envía los campos modificados. Por ejemplo, aumentar el límite de capacidad de la directiva de ejemplo a 32 CU y mantener su límite de inactividad de 15 minutos:
curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID?update_mask=allowed_compute_products" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "allowed_compute_products": { "lakebase": { "max_capacity_units_per_instance": 32, "max_idle_minutes_before_scale_to_zero": 15 } } }'Compruebe la directiva devuelta para verificar el límite actualizado.
Actualizar el lakebase objeto reemplaza sus restricciones. Incluye todas las restricciones de Lakebase que pretendas conservar. Por ejemplo, omitir un límite de tiempo ocioso existente elimina ese límite. Un objeto vacío lakebase elimina sus límites mientras continúa permitiendo Lakebase. Las rutas de máscara anidadas, como allowed_compute_products.lakebase.max_capacity_units_per_instance, no son compatibles.
Para renombrar una política sin cambiar sus restricciones, use update_mask=display_name y un cuerpo como {"display_name": "Lakebase application policy"}.
Reducir el límite de capacidad de una política de 16 a 8 CU deja sin cambios la capacidad de proceso existente de 16 CU. Cualquier cambio posterior de capacidad debe cumplir con el límite de 8-CU. Al cambiar a una política diferente, el cómputo existente debe cumplir las restricciones de esa política antes de que la actualización pueda completarse.
Eliminar una directiva
Eliminar una política no elimina la computación creada usando esa política. La aplicación de sus restricciones depende de que la política siga existiendo y permanezca adherida.
Antes de eliminar una política personalizada:
-
Enumera los proyectos de Lakebase, siguiendo los valores de
next_page_token. Encuentra proyectos de Lakebase cuyostatus.compute_policy_idcoincida con la política que planeas eliminar. - Confirme que el inventario cubre todos los proyectos de Lakebase afectados.
CAN_MANAGEen una política no concede acceso a todos los proyectos de Lakebase que la utilicen. Coordina con los propietarios de proyectos de Lakebase o con un administrador del espacio de trabajo para proyectos que no puedas ver. - Sustituya la política sobre proyectos Lakebase afectados antes de eliminarla si esos proyectos deben seguir regidos por una política.
Para eliminar una directiva personalizada, ejecute:
curl --fail-with-body -sS -X DELETE \
"$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID" \
-H "Authorization: Bearer $DATABRICKS_TOKEN"
La Política predeterminada de Lakebase no puede eliminarse.
Troubleshooting
| Error o condición | Action |
|---|---|
PERMISSION_DENIED al crear un proyecto de Lakebase |
Verifica que tienes CAN_USE o CAN_MANAGE en una política que permita Lakebase. Si omites el ID de la política, necesitas acceso a la Política predeterminada de Lakebase. |
PERMISSION_DENIED al actualizar la configuración del recurso |
Verifica tu permiso para gestionar el recurso. Los cambios en la configuración de cálculo regida por la política también requieren CAN_USE o CAN_MANAGE en la política, incluso si la política no establece límite para la configuración. Consulte Permisos para cambios de configuración. |
PERMISSION_DENIED al reemplazar una política adjunta |
Verifique su permiso para gestionar el recurso y CAN_USE o CAN_MANAGE en la política actual y en su reemplazo. |
BAD_REQUEST porque la capacidad supera el máximo de la política |
Reduce autoscaling_limit_max_cu en la configuración del endpoint o en los valores predeterminados de computación del proyecto Lakebase para ajustarlos al límite de CU de la política. |
BAD_REQUEST porque el tiempo de espera de inactividad supera el máximo de la política |
Active la escala a cero y elija un tiempo de espera de inactividad igual o inferior al límite de la política, en un cálculo que soporte escala a cero. |
INVALID_PARAMETER_VALUE al crear o actualizar una política |
Compruebe que el nombre no esté en blanco y tenga como máximo 127 caracteres, que haya al menos un producto informático, que los límites sean enteros positivos y que la máscara de actualización contenga rutas admitidas. Los nombres y la configuración de las políticas predeterminadas no se pueden cambiar. |
ALREADY_EXISTS al nombrar una política |
Elija otro nombre. Los nombres de las políticas predeterminadas están reservados. |
Limitaciones
Gestión de políticas
- Las políticas se limitan a un espacio de trabajo. Crea y otorga acceso a las políticas en cada espacio de trabajo donde las utilices.
- La política predeterminada de Lakebase no puede eliminarse ni modificarse su nombre ni su configuración. Los administradores del espacio de trabajo pueden conceder o revocar permisos sobre él.
- Eliminar una política de un recurso requiere sustituirla. Necesitas permiso para gestionar el recurso y
CAN_USEoCAN_MANAGEen ambas políticas. El cómputo existente debe cumplir las restricciones de la política de reemplazo antes de que la actualización pueda completarse. - Endurecer una política no cambia los recursos de computación existentes. Los cambios posteriores en los ajustes regulados deben cumplir con los límites actualizados.
- Eliminar una directiva personalizada no elimina los recursos informáticos creados usando esa directiva. La aplicación de las restricciones de esa política depende de la existencia continuada de la misma.
- La API de políticas no devuelve etiquetas en las respuestas get o list, ni soporta cambiar etiquetas a través del endpoint de actualización de políticas.
Lakebase Compute
- Cambiar la capacidad de cálculo o la configuración de escalar a cero requiere
CAN_MANAGEen el proyecto Lakebase yCAN_USEoCAN_MANAGEen su política. Esto es así incluso si la política no establece ningún límite para este ajuste. - Escalar a cero requiere un tamaño máximo de computación de 32 CU o menos. Si una política requiere un límite de tiempo inactivo, elija un tamaño de cálculo compatible. Consulta Configurar escala a cero.
- La alta disponibilidad utiliza un grupo de cómputo con múltiples nodos y requiere desactivar la escala a cero. El límite de tiempo ocioso de la directiva no se aplica a estos grupos. Los límites de capacidad siguen aplicándose.
- Cambiar los valores predeterminados de cómputo de un proyecto Lakebase afecta a los nuevos recursos de cómputo. Actualice por separado los endpoints de computación existentes para cambiar su capacidad o su tiempo de espera de inactividad.
Compatibilidad de la API de instancias de base de datos
La API de instancias de base de datos sigue disponible para la automatización existente. Utiliza nombres de instancia y niveles de capacidad provisionada, y crea proyectos Lakebase en la plataforma de Autoescalado. Utiliza la API de Postgres para nuevas integraciones. Los proyectos de Lakebase creados a través de la API de Postgres o de la interfaz de usuario de Lakebase no pueden gestionarse mediante la API de instancias de base de datos. Consulte API.
La API de instancias de base de datos utiliza la Política predeterminada de Lakebase. Crear un proyecto Lakebase a través de esta API requiere CAN_USE o CAN_MANAGE en esa política. Omite compute_policy_id o déjalo vacío. Un valor no vacío se rechaza tanto en solicitudes de creación como en solicitudes de actualización. Para seleccionar una directiva personalizada, utilice la API de Postgres.
La API de compatibilidad utiliza los siguientes campos:
| Purpose | Campo API de instancias de base de datos |
|---|---|
| Compruebe la directiva aplicada |
effective_compute_policy_id en la respuesta de instancia. |
| Configurar la capacidad |
capacity, usando una capa provisionada como CU_1. Consulta el mapeo de niveles. |
| Seleccione una política de uso serverless | Nivel superior. Se aplican las etiquetas de ambas políticas. |
Los usuarios sin acceso a la política predeterminada deben utilizar la API de Postgres con una política personalizada que puedan utilizar para crear un proyecto Lakebase.