Modifica una instancia de Bigtable

Después de crear una instancia de Cloud Bigtable, puedes actualizar cualquiera de las siguientes configuraciones sin tiempo de inactividad:

  • La cantidad de nodos de cada clúster

    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

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

  • El nombre visible de la instancia

Solo puedes cambiar el ID de un 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 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 herramientas de línea de comandos de Bigtable, instala el SDK de Cloud y la herramienta de línea de comandos de cbt si aún no lo hiciste.

Agrega o quita nodos

Los nodos son recursos de procesamiento que un clúster de Bigtable usa para acceder a los datos y ejecutar tareas administrativas. Debes supervisar el uso de CPU y del disco de cada clúster para asegurarte de que tenga nodos suficientes. Si deseas obtener más información sobre cómo la cantidad de nodos afecta al rendimiento de un clúster, consulta la sección Rendimiento en cargas de trabajo típicas.

De forma predeterminada, puedes aprovisionar hasta 30 nodos de Bigtable por zona en cada proyecto de Google Cloud. Si necesitas aprovisionar más nodos que el límite predeterminado, usa el formulario de solicitud de nodos.

Para cambiar la cantidad de nodos de un clúster, sigue estos pasos:

Console

  1. Abre la lista de instancias de Bigtable en Cloud Console.

    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 el ícono de lápiz (editar) junto al clúster que deseas actualizar.

  4. En Nodos, 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.

  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: La cantidad de nodos en el clúster. Cada clúster de una instancia debe tener 1 o más 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.

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: La cantidad de nodos en el clúster. Cada clúster de una instancia debe tener 1 o más 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 y borra clústeres

Una instancia puede tener hasta 4 clústeres. Las instancias con 2 o más clústeres usan la replicación automáticamente.

Agrega un clúster

Puedes agregar clústeres a una instancia existente, hasta un máximo de 4 clústeres por instancia. Los clústeres pueden estar en cualquier región donde esté disponible Bigtable, siempre y cuando cada clúster esté en una zona diferente. Las ubicaciones ideales de los clústeres adicionales dependen de tu caso práctico.

Si tu instancia está protegida por CMEK, no puedes agregar un clúster que no esté en la misma región que tu clave de CMEK, y el nuevo clúster debe usar la misma clave de CMEK que los otros clústeres de la instancia.

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 Cloud Console.

    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 de un clúster, y selecciona su región y zona.

  5. 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.

  6. Haz clic en Actualizar.

  7. 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.

  8. A continuación, revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso práctico 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] \
        [--storage-type=STORAGE_TYPE]
    

    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

      Los clústeres de una instancia deben estar en zonas únicas. Puedes crear un clúster adicional en cualquier zona en la que Bigtable esté disponible. Por ejemplo, si el primer clúster está en us-east1-b, puede elegir una zona diferente en la misma región, como us-east1-c, o una zona en otra región, 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:

    • --num-nodes=NUM_NODES: La cantidad de nodos en el clúster. Cada clúster de una instancia debe tener 1 o más nodos. El valor predeterminado es 1.

      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=STORAGE_TYPE: 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.

  4. A continuación, revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso práctico 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

      Los clústeres de una instancia deben estar en zonas únicas. Puedes crear un clúster adicional en cualquier zona en la que Bigtable esté disponible. Por ejemplo, si el primer clúster está en us-east1-b, puede elegir una zona diferente en la misma región, como us-east1-c, o una zona en otra región, como europe-west2-a. Consulta la lista de zonas.

    • NUM_NODES: La cantidad de nodos en el clúster. Cada clúster de una instancia debe tener 1 o más 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.

    • STORAGE_TYPE: 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. A continuación, revisa la configuración de la replicación en el perfil de app predeterminado a fin de comprobar si funciona para tu caso práctico de replicación. Es posible que debas actualizar el perfil de aplicación predeterminado o crear perfiles de aplicación 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 Cloud Console.

    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 el ícono de papelera (borrar) junto al 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

Administra los perfiles de aplicación

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 deseas obtener ejemplos de la configuración que puedes usar para implementar casos prácticos comunes, consulta Ejemplos de la configuración de la replicación.

Administrar las 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.

Cambiar el nombre visible de una instancia

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

Console

  1. Abre la lista de instancias de Bigtable en Cloud Console.

    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 Cloud Console.

cbt

Esta función no está disponible en la herramienta de cbt.

¿Qué sigue?