Modificar una instancia

Después de crear una instancia de Bigtable, puedes actualizar los siguientes parámetros de configuración sin tiempo de inactividad:

  • Edición

    Puedes actualizar a Enterprise Plus o cambiar a Enterprise.

  • En memoria (Vista previa)

    Puedes habilitar o inhabilitar el nivel en memoria para un clúster en una instancia.

  • Ajuste de escala automático

    Puedes habilitar o inhabilitar el ajuste de escala automático para los clústeres de una instancia o configurar los parámetros de clústeres que ya tienen habilitado el ajuste de escala automático.

  • La cantidad de nodos de los clústeres escalados de forma manual

    Cuando se agregan o quitan nodos, Bigtable, por lo general, tarda unos minutos en optimizar el rendimiento del clúster.

  • La cantidad de clústeres de la instancia

    Cuando agregas un clúster, Bigtable demora en replicar tus datos en el clúster nuevo. Los clústeres nuevos se replican desde el clúster más cercano geográficamente en la instancia. En general, cuanto mayor sea la distancia, más larga será la replicación.

  • Los perfiles de aplicación de la instancia, que contienen la configuración de replicación

  • La ubicación de tus datos.

  • Las etiquetas de la instancia, que se encargan de proporcionar los metadatos

  • El nombre visible de la instancia

Solo puedes cambiar un ID del clúster si borras y vuelves a crear el clúster.

Para cambiar cualquiera de las siguientes opciones, debes crear una instancia nueva con tu configuración preferida; exporta tus datos desde la instancia anterior; importa tus datos a la instancia nueva; y luego borra la instancia anterior.

  • ID de instancia

  • Tipo de almacenamiento (SSD o HDD)

  • Configuración de la clave de encriptación administrada por el cliente (CMEK)

Antes de comenzar

Si quieres usar las interfaces de línea de comandos de Bigtable, instala Google Cloud CLI y la CLI de cbt si aún no lo hiciste.

Cambiar de edición

Puedes cambiar de edición actualizando a Enterprise Plus o regresando a Enterprise.

Actualiza a Enterprise Plus

Una vez que cambies la edición, Bigtable actualizará automáticamente la facturación y tendrás acceso inmediato a las funciones de Enterprise Plus.

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia de Enterprise que deseas actualizar y, luego, en Editar instancia.

  3. En la sección Edición, selecciona Enterprise Plus.

  4. Haz clic en Guardar.

  5. Opcional: Habilita el nivel en la memoria.

gcloud

Usa el comando bigtable instances update para cambiar la edición:

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE_PLUS

Proporcione lo siguiente:

  • INSTANCE_ID: Identificador permanente de la instancia.

Cambiar a la versión inferior de Enterprise

Para cambiar de Enterprise Plus a Enterprise, debes inhabilitar las funciones exclusivas de Enterprise Plus. Una vez que cambies la edición, Bigtable actualizará automáticamente la facturación y perderás el acceso a las funciones de Enterprise Plus.

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia de Enterprise a la que deseas cambiar a una versión anterior y, luego, en Editar instancia.

  3. En la sección Edición, selecciona Enterprise.

  4. Haz clic en Guardar.

gcloud

Usa el comando bigtable instances update para cambiar la edición:

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE

Proporcione lo siguiente:

  • INSTANCE_ID: Identificador permanente de la instancia.

Configura la opción en memoria

Puedes habilitar o inhabilitar el nivel en la memoria, o bien ver información sobre él.

Roles obligatorios

Para obtener los permisos que necesitas para configurar el nivel en memoria, pídele a tu administrador que te otorgue el rol de administrador de Bigtable (roles/bigtable.admin) de Identity and Access Management (IAM) en la instancia.

Este rol predefinido contiene los permisos que Bigtable requiere para trabajar con el nivel en memoria. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:

Permisos necesarios

  • bigtable.memoryLayer.get
  • bigtable.memoryLayer.list
  • bigtable.memoryLayer.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre los roles y permisos de Bigtable, consulta Control de acceso con IAM.

Habilitar el nivel en la memoria

En la edición Enterprise Plus, puedes habilitar el nivel en la memoria en un clúster. Para usar el nivel en memoria, debes usar un perfil de app que hayas configurado para la memoria. Para obtener más información, consulta la Descripción general de la memoria.

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia de Enterprise que deseas actualizar y, luego, en Editar instancia.

  3. Haz clic en Editar clúster en el clúster en el que deseas habilitar el nivel en memoria.

  4. Selecciona Habilitar en la memoria.

  5. Haz clic en Guardar.

gcloud

En la edición Enterprise Plus, para habilitar el nivel en la memoria en un clúster, usa el comando gcloud beta bigtable memory-layers update. 

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --enable

Proporcione lo siguiente:

  • CLUSTER_ID: Identificador permanente del clúster.
  • INSTANCE_ID: Identificador permanente de la instancia.

Inhabilita el nivel en la memoria

Antes de cambiar de Enterprise Plus a Enterprise, debes inhabilitar el nivel en memoria.

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia de Enterprise que deseas actualizar y, luego, en Editar instancia.

  3. Haz clic en Editar clúster en el clúster en el que deseas inhabilitar el nivel en memoria.

  4. Borra Habilitar en la memoria.

  5. Haz clic en Guardar.

gcloud

Para inhabilitar el nivel en memoria en un clúster, usa el comando gcloud beta bigtable memory-layers update.

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --disable

Proporcione lo siguiente:

  • CLUSTER_ID: Identificador permanente del clúster.
  • INSTANCE_ID: Identificador permanente de la instancia.

Cómo ver información sobre el nivel en la memoria

Puedes ver el estado y la capacidad del nivel en la memoria de un clúster.

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en el ID de la instancia que tiene el clúster que deseas ver.

  3. En la tabla del clúster, consulta la columna En memoria de tu clúster.

gcloud

Para ver información sobre el nivel en memoria de un clúster, como el estado en memoria, usa el comando gcloud beta bigtable memory-layers describe. 

gcloud beta bigtable memory-layers describe CLUSTER_ID \
    --instance=INSTANCE_ID

Proporcione lo siguiente:

  • CLUSTER_ID: Identificador permanente del clúster.
  • INSTANCE_ID: Identificador permanente de la instancia.

Configurar ajuste de escala automático

Puedes habilitar o inhabilitar el ajuste de escala automático para cualquier clúster existente. También puedes cambiar el objetivo de uso de CPU, la cantidad mínima de nodos y la cantidad máxima de nodos para un clúster. Para obtener orientación sobre cómo elegir tu configuración de ajuste de escala automático, consulta Ajuste de escala automático. No puedes usar la CLI de cbt para configurar el ajuste de escala automático.

Habilitar ajuste de escala automático

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. En Configura los clústeres, haz clic en Editar en el clúster que deseas actualizar.

  4. Selecciona Ajuste de escala automático.

  5. Ingresa valores para lo siguiente:

    • Cantidad mínima de nodos
    • Cantidad máxima de nodos
    • Objetivo de uso de CPU
    • Objetivo de uso de almacenamiento

  6. Haz clic en Guardar.

gcloud

  1. Si no conoces el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list

  2. Si no conoces los ID de clúster de la instancia, usa el comando bigtable clusters list para ver una lista de clústeres de la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters update para habilitar el ajuste de escala automático:

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --autoscaling-max-nodes=AUTOSCALING_MAX_NODES \
    --autoscaling-min-nodes=AUTOSCALING_MIN_NODES \
    --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
    --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET

    Proporcione lo siguiente:

    • CLUSTER_ID: Identificador permanente del clúster.
    • INSTANCE_ID: Identificador permanente de la instancia.
    • AUTOSCALING_MAX_NODES: La cantidad mínima de nodos
    • AUTOSCALING_MIN_NODES: La cantidad máxima de nodos
    • AUTOSCALING_CPU_TARGET: El porcentaje objetivo de uso de CPU que mantiene Bigtable mediante la adición o la eliminación de nodos. Este valor debe ser de 10 a 80.

    • AUTOSCALING_STORAGE_TARGET: el objetivo de uso de almacenamiento en GiB por nodo que mantiene Bigtable mediante la agregación o la eliminación de nodos.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

Inhabilita el ajuste de escala automático

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. En Configura los clústeres, haz clic en para el clúster que deseas actualizar.

  4. Selecciona Asignación manual de nodos.

  5. Ingresa la cantidad de nodos del clúster en el campo Cantidad.

    En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

  6. Haz clic en Guardar.

gcloud

  1. Si no conoces el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list

  2. Si no conoces los ID de clúster de la instancia, usa el comando bigtable clusters list para ver una lista de clústeres de la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters update para inhabilitar el ajuste de escala automático y configurar una cantidad constante de nodos:

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --num-nodes=NUM_NODES --disable-autoscaling

    Proporcione lo siguiente:

    • CLUSTER_ID: Identificador permanente del clúster.
    • INSTANCE_ID: Identificador permanente de la instancia.

    • NUM_NODES: Este campo es opcional. Si no se establece ningún valor, Bigtable asigna automáticamente nodos en función de tu huella de datos y optimiza la utilización del almacenamiento en un 50%. Si quieres controlar la cantidad de nodos en un clúster, actualiza el valor de NUM_NODES. Asegúrate de que la cantidad de nodos esté establecida en un valor distinto de cero.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

Cambia la configuración del ajuste de escala automático

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. En Configura los clústeres, haz clic en para el clúster que deseas actualizar.

  4. Ingresa valores nuevos para cualquiera de los parámetros siguientes que desees cambiar:

    • Cantidad mínima de nodos
    • Cantidad máxima de nodos
    • Objetivo de uso de CPU
    • Objetivo de uso de almacenamiento

  5. Haz clic en Guardar.

gcloud

  1. Si no conoces el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list

  2. Si no conoces los ID de clúster de la instancia, usa el comando bigtable clusters list para ver una lista de clústeres de la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters update a fin de actualizar la configuración para el ajuste de escala automático:

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --autoscaling-max-nodes=AUTOSCALING_MAX_NODES \
    --autoscaling-min-nodes=AUTOSCALING_MIN_NODES \
    --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
    --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET

    Proporcione lo siguiente:

    • CLUSTER_ID: Identificador permanente del clúster.
    • INSTANCE_ID: Identificador permanente de la instancia.

    El comando acepta marcas de ajuste de escala automático opcionales. Puedes usar todas las marcas o solo las marcas para los valores que deseas cambiar.

    • AUTOSCALING_MAX_NODES: La cantidad mínima de nodos.
    • AUTOSCALING_MIN_NODES: La cantidad máxima de nodos.
    • AUTOSCALING_CPU_TARGET: El porcentaje objetivo de uso de CPU que mantiene Bigtable mediante la adición o la eliminación de nodos. Este valor debe ser de 10 a 80.

    • AUTOSCALING_STORAGE_TARGET: El objetivo de uso de almacenamiento en GiB por nodo que mantiene Bigtable mediante la agregación o la eliminación de nodos.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

Agrega o quita nodos de forma manual

En la mayoría de los casos, te recomendamos que habilites el ajuste de escala automático. Si decides no hacerlo y el modo de escalamiento de nodos de tu clúster es manual, puedes agregar o quitar nodos, y la cantidad de nodos permanece constante hasta que vuelvas a cambiarla. Para revisar las cuotas predeterminadas de nodos por zona por Google Cloud proyecto, consulta Cuotas de nodos. Si necesitas aprovisionar más nodos que los predeterminados, puedes solicitar más.

Para cambiar la cantidad de nodos de un clúster que usa el ajuste de escala manual, haz lo siguiente:

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. En Configura los clústeres, haz clic en Editar en el clúster que deseas actualizar.

  4. En la sección Asignación manual de nodos, ingresa la cantidad de nodos del clúster en el campo Cantidad.

    En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

  5. Haz clic en Guardar.

gcloud

  1. Si no conoces el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list

  2. Si no conoces los ID de clúster de la instancia, usa el comando bigtable clusters list para ver una lista de clústeres de la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters update para cambiar la cantidad de nodos:

    gcloud bigtable clusters update CLUSTER_ID \
    --instance=INSTANCE_ID \
    --num-nodes=NUM_NODES

    Proporcione lo siguiente:

    • CLUSTER_ID: Identificador permanente del clúster.
    • INSTANCE_ID: Identificador permanente de la instancia.

    • NUM_NODES: Este campo es opcional. Si no se establece ningún valor, Bigtable asigna automáticamente nodos en función de tu huella de datos y optimiza la utilización del almacenamiento en un 50%. Si quieres controlar la cantidad de nodos en un clúster, actualiza el valor de NUM_NODES. Asegúrate de que la cantidad de nodos esté establecida en un valor distinto de cero.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

cbt

  1. Si no conoces el ID de instancia, usa el comando listinstances para ver una lista de las instancias de tu proyecto:

    cbt listinstances

  2. Si no conoces los ID de los clústeres de la instancia, usa el comando listclusters para ver una lista de los clústeres de la instancia:

    cbt -instance=INSTANCE_ID listclusters

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando updatecluster para cambiar la cantidad de nodos:

    cbt -instance=INSTANCE_ID updatecluster CLUSTER_ID NUM_NODES

    Proporcione lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia.
    • CLUSTER_ID: Identificador permanente del clúster.

    • NUM_NODES: Este campo es opcional. Si no se establece ningún valor, Bigtable asigna automáticamente nodos en función de tu huella de datos y optimiza la utilización del almacenamiento en un 50%. Si quieres controlar la cantidad de nodos en un clúster, actualiza el valor de NUM_NODES. Asegúrate de que la cantidad de nodos esté establecida en un valor distinto de cero.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

Agrega un clúster

Puedes agregar clústeres a una instancia existente. Una instancia puede tener clústeres en hasta 8 regiones en las que Bigtable esté disponible. Cada zona de una región puede contener solo un clúster. Las ubicaciones ideales de los clústeres adicionales dependen de tu caso de uso.

Si tu instancia está protegida por CMEK, cada clúster nuevo debe usar una clave CMEK que se encuentre en la misma región que el clúster. Antes de agregar un clúster nuevo a una instancia protegida por CMEK, identifica o crea una clave CMEK en la región en la que planeas ubicar el clúster.

Antes de agregar clústeres a una instancia de un solo clúster, consulta las restricciones que se aplican cuando cambias las políticas de recolección de elementos no utilizados para tablas replicadas. Luego, consulta Ejemplos de la configuración de la replicación para obtener recomendaciones.

Para agregar un clúster a la instancia, sigue estos pasos:

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. En Configura los clústeres, haz clic en Agregar clúster.

    Si este botón está inhabilitado, la instancia ya tiene la cantidad máxima de clústeres.

  4. Ingresa el ID del clúster para el primer clúster.

    El ID del clúster es un identificador permanente del clúster.

  5. Elige la región y zona en la que se ejecutará el primer clúster.

  6. Opcional: Para configurar el clúster de modo que siempre se reduzca la escala en incrementos de dos nodos, selecciona Habilitar el escalamiento de dos nodos. Para obtener más información, consulta Factor de escalamiento de nodos.

  7. Elige un modo de escalamiento de nodos para el clúster. En la mayoría de los casos, debes elegir el ajuste de escala automático. Para obtener orientación sobre el escalamiento, consulta Ajuste de escala automático.

    1. En Asignación de nodos manual, ingresa la cantidad de nodos de Bigtable del primer clúster. Si no estás seguro de cuántos nodos necesitas, usa el valor predeterminado. Posteriormente, puedes agregar más nodos.
    2. En Ajuste de escala automático, ingresa los valores de lo siguiente:
      • Cantidad mínima de nodos
      • Cantidad máxima de nodos
      • Objetivo de uso de CPU
      • Objetivo de uso de almacenamiento

  8. Opcional: Para proteger tu instancia con CMEK en lugar de la encriptación predeterminada administrada por Google, completa los siguientes pasos:

    1. Haz clic en Mostrar opciones de encriptación.
    2. Selecciona el botón de radio junto a Clave de encriptación administrada por el cliente (CMEK).
    3. Selecciona o ingresa el nombre del recurso para la clave de CMEK que deseas usar para el clúster. No podrás agregar esto más adelante.
    4. Si se te solicita que otorgues permiso a la cuenta de servicio de la clave CMEK, haz clic en Otorgar. Tu cuenta de usuario debe tener la función de administrador de Cloud KMS para completar esta tarea.
    5. Haz clic en Guardar.

  9. Ingresa la cantidad de nodos del clúster.

    En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

  10. Si la instancia está protegida por CMEK, selecciona o ingresa una clave administrada por el cliente. La clave CMEK debe estar en la misma región que el clúster.

  11. Haga clic en Agregar.

  12. Repite estos pasos para cada clúster adicional y, luego, haz clic en Guardar. Bigtable crea el clúster y comienza a replicar tus datos en el clúster nuevo. Es posible que notes un aumento en el uso de CPU cuando comience la replicación.

  13. Revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso de uso de replicación. Es posible que debas actualizar el perfil de app predeterminado o crear perfiles de app personalizados.

gcloud

  1. Si no conoces el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list

  2. Si no conoces los ID de clúster de la instancia, usa el comando bigtable clusters list para ver una lista de clústeres de la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters create para agregar un clúster:

    gcloud bigtable clusters create CLUSTER_ID \
    --async \
    --instance=INSTANCE_ID \
    --zone=ZONE \
    [--num-nodes=NUM_NODES] \
    [--autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \
    --autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \
    --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
    --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET] \
    [--kms-key=KMS_KEY --kms-keyring=KMS_KEYRING \
    --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] \

    Proporcione lo siguiente:

    • CLUSTER_ID: Identificador permanente del clúster.
    • INSTANCE_ID: Identificador permanente de la instancia.

    • ZONE: La zona donde se ejecuta el clúster.

      Cada zona de una región puede contener solo un clúster. Por ejemplo, si una instancia tiene un clúster en us-east1-b, puedes agregar un clúster en una zona diferente en la misma región, como us-east1-c, o una zona en una región distinta, como europe-west2-a. Consulta la lista de zonas.

    La marca --async no es obligatoria, pero es muy recomendable. Sin esta marca, es posible que el comando agote el tiempo de espera antes de completar la operación. Bigtable continuará con la creación del clúster en segundo plano.

    El comando acepta las siguientes marcas opcionales:

    • --kms-key=KMS_KEY: es la clave CMEK que usa el clúster. Puedes agregar clústeres de CMEK solo a instancias que ya están protegidas con CMEK.
    • --kms-keyring=KMS_KEYRING: es el ID del llavero de claves de KMS.
    • --kms-location=KMS_LOCATION: Es la Google Cloud ubicación de la clave.
    • --kms-project=KMS_PROJECT: Es el ID del proyecto de la clave. Google Cloud
    • --storage-type=STORAGE_TYPE: Es el tipo de almacenamiento que se usará en el clúster. Todos los clústeres de una instancia deben usar el mismo tipo de almacenamiento. Acepta los valores SSD y HDD. El valor predeterminado es SSD.
    • --node-scaling-factor=node-scaling-factor-2x: Es una marca que habilita el escalamiento de nodos 2x. Puedes habilitar esta función con el ajuste de escala automático y manual.

    Para ver una lista de las zonas de Bigtable que no están disponibles para el ajuste de escala de nodos 2x, consulta Limitaciones del factor de escala de nodos.

    Si no se establece ningún valor para la opción --num-nodes, Bigtable asigna nodos al clúster automáticamente en función de tu huella de datos y optimiza la utilización del almacenamiento en un 50%. Esta asignación automática de nodos tiene un impacto en los precios. Si quieres controlar la cantidad de nodos en un clúster, actualiza el valor de NUM_NODES. Asegúrate de que la cantidad de nodos esté establecida en un valor distinto de cero. En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

    Para el ajuste de escala automático, proporciona todas las marcas autoscaling- y no uses num-nodes. Consulta Ajuste de escala automático para obtener orientación sobre cómo elegir los valores para tu configuración de ajuste de escala automático. Reemplaza lo siguiente:

    • AUTOSCALING_MIN_NODES: La cantidad mínima de nodos para el clúster.
    • AUTOSCALING_MAX_NODES: La cantidad máxima de nodos para el clúster.
    • AUTOSCALING_CPU_TARGET: El uso de CPU objetivo para el clúster. Este valor debe ser de 10 a 80.
    • AUTOSCALING_STORAGE_TARGET: el objetivo de uso de almacenamiento en GiB que mantiene Bigtable mediante el agregado o la eliminación de nodos.

  4. Revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso de uso de replicación. Es posible que debas actualizar el perfil de app predeterminado o crear perfiles de app personalizados.

cbt

  1. Si no conoces el ID de instancia, usa el comando listinstances para ver una lista de las instancias de tu proyecto:

    cbt listinstances

  2. Si no conoces los ID de los clústeres de la instancia, usa el comando listclusters para ver una lista de los clústeres de la instancia:

    cbt -instance=INSTANCE_ID listclusters

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando createcluster para agregar un clúster:

    
cbt -instance=INSTANCE_ID \
createcluster CLUSTER_ID \
ZONE \
NUM_NODES \
STORAGE_TYPE

    Proporcione lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia.
    • CLUSTER_ID: Identificador permanente del clúster.

    • ZONE: La zona donde se ejecuta el clúster.

      Cada zona de una región puede contener solo un clúster. Por ejemplo, si una instancia tiene un clúster en us-east1-b, puedes agregar un clúster en una zona diferente en la misma región, como us-east1-c, o una zona en una región distinta, como europe-west2-a. Consulta la lista de zonas.

    • NUM_NODES: Este campo es opcional. Si no se establece ningún valor, Bigtable asigna automáticamente nodos en función de tu huella de datos y optimiza la utilización del almacenamiento en un 50%. Si quieres controlar la cantidad de nodos en un clúster, actualiza el valor de NUM_NODES. Asegúrate de que la cantidad de nodos esté establecida en un valor distinto de cero.

      En muchos casos, todos los clústeres de una instancia deben tener la misma cantidad de nodos, pero hay excepciones. Más información sobre los nodos y la replicación.

    • STORAGE_TYPE: Es el tipo de almacenamiento que se usará en el clúster. Todos los clústeres de una instancia deben usar el mismo tipo de almacenamiento. Acepta los valores SSD y HDD.

  4. Revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso de uso de replicación. Es posible que debas actualizar el perfil de app predeterminado o crear perfiles de app personalizados.

Borra un clúster

Si una instancia tiene varios clústeres, puedes borrar todos los clústeres, excepto 1. Si borras todos los clústeres, excepto 1, la replicación se inhabilita automáticamente.

En algunos casos, Bigtable no te permite borrar un clúster:

  • Si uno de tus perfiles de aplicación enruta todo el tráfico a un solo clúster, Bigtable no te dejará borrarlo. Debes editar o borrar el perfil de aplicación para poder quitar el clúster.
  • Si agregas clústeres nuevos a una instancia existente, no puedes borrar los clústeres en esa instancia hasta que se complete la copia inicial de datos en los clústeres nuevos.

Para borrar un clúster de una instancia, sigue estos pasos:

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. En Configura los clústeres, haz clic en Borrar clúster en el clúster que deseas borrar.

  4. Para cancelar la operación de eliminación, haz clic en Deshacer, que está disponible hasta que hagas clic en Guardar. De lo contrario, haz clic en Guardar.

gcloud

  1. Si no conoces el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list

  2. Si no conoces los ID de clúster de la instancia, usa el comando bigtable clusters list para ver una lista de clústeres de la instancia:

    gcloud bigtable clusters list --instances=INSTANCE_ID

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando bigtable clusters delete para borrar el clúster:

    gcloud bigtable clusters delete CLUSTER_ID \
    --instance=INSTANCE_ID

    Proporcione lo siguiente:

    • CLUSTER_ID: Identificador permanente del clúster.
    • INSTANCE_ID: Identificador permanente de la instancia.

cbt

  1. Si no conoces el ID de instancia, usa el comando listinstances para ver una lista de las instancias de tu proyecto:

    cbt listinstances

  2. Si no conoces los ID de los clústeres de la instancia, usa el comando listclusters para ver una lista de los clústeres de la instancia:

    cbt -instance=INSTANCE_ID listclusters

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

  3. Usa el comando deletecluster para borrar el clúster:

    cbt -instance=INSTANCE_ID deletecluster CLUSTER_ID

    Proporcione lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia.
    • CLUSTER_ID: Identificador permanente del clúster.

Mueve datos a una ubicación nueva

Para mover los datos en una instancia de Bigtable a una zona o región nueva, agrega un clúster nuevo en la ubicación a la que deseas moverlos y, luego, borra el clúster en la ubicación desde la que deseas moverlos. El clúster borrado permanece disponible hasta que los datos se hayan replicado en el clúster nuevo, por lo que no tienes que preocuparte por ninguna solicitud con errores. Bigtable replica todos los datos en el clúster nuevo de forma automática.

Administra perfiles de app

Los perfiles de aplicación controlan la manera en que tus aplicaciones se conectan a una instancia que usa la replicación. Todas las instancias con más de 1 clúster tienen su propio perfil de aplicación predeterminado. También puedes crear varios perfiles de aplicación personalizados para cada instancia y asignar uno distinto a cada tipo aplicación que uses.

Si deseas aprender a configurar los perfiles de aplicación de una instancia, consulta Cómo configurar los perfiles de aplicación. Si quieres obtener ejemplos de la configuración que puedes usar para implementar casos prácticos comunes, consulta Ejemplos de configuraciones de replicación.

Administrar etiquetas

Las etiquetas son pares clave-valor que puedes usar para agrupar las instancias relacionadas y almacenar metadatos de una instancia.

Si deseas aprender a administrar etiquetas, consulta las secciones Cómo agregar o actualizar las etiquetas de la instancia y Cómo quitar una etiqueta de una instancia.

Cambia el nombre visible de una instancia

Si deseas cambiar el nombre visible de una instancia que la consola de Google Cloud usa para identificarla, sigue estos pasos:

Console

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que deseas modificar y, luego, en Editar instancia.

  3. Edita el nombre de la instancia y, luego, haz clic en Guardar.

gcloud

  1. Si no conoces el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list

  2. Usa el comando bigtable instances update para actualizar el nombre visible:

    gcloud bigtable instances update INSTANCE_ID \
    --display-name=DISPLAY_NAME

    Proporcione lo siguiente:

    • INSTANCE_ID: Identificador permanente de la instancia.
    • DISPLAY_NAME: Un nombre legible que identifica la instancia en la Google Cloud consola.

cbt

Esta función no se encuentra disponible en la CLI de cbt.

¿Qué sigue?