Crea una instancia y escribe datos con la CLI de “cbt”

Si estás aprendiendo sobre Bigtable, puedes trabajar con una guía de inicio rápido para conocer los conceptos básicos que aplicarías a gran escala en un entorno de producción.

En esta guía de inicio rápido, harás lo siguiente:

• Conéctate a una instancia de Bigtable.
• Realizar tareas administrativas básicas
• Escribir datos en una tabla
• Leer datos de una tabla

Antes de comenzar

Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Para inicializar gcloud CLI, ejecuta el siguiente comando:
gcloud init
Crea o selecciona un Google Cloud proyecto.
Roles necesarios para seleccionar o crear un proyecto
• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén información para otorgar roles.
Nota: Si no planeas conservar los recursos que creas en este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Después de completar estos pasos, puedes borrar el proyecto y quitar todos los recursos asociados a él.
• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre del Google Cloud proyecto.
Verifica que la facturación esté habilitada para el Google Cloud proyecto.
Habilita las APIs de Cloud Bigtable y Cloud Bigtable Admin:
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el rol de IAM de administrador de uso de servicios (roles/serviceusage.serviceUsageAdmin), que contiene el serviceusage.services.enable permiso. Obtén información para otorgar roles.
gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
Otorga roles a tu cuenta de usuario. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Reemplaza lo siguiente:
• PROJECT_ID: ID del proyecto
• USER_IDENTIFIER: Es el identificador de tu cuenta de usuario. Por ejemplo, [e-mail].
• ROLE: Es el rol de IAM que otorgas a tu cuenta de usuario.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén información para otorgar roles.

Nota: Si no planeas conservar los recursos que creas en este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Después de completar estos pasos, puedes borrar el proyecto y quitar todos los recursos asociados a él.

• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre del Google Cloud proyecto.

Verifica que la facturación esté habilitada para el Google Cloud proyecto.

Habilita las APIs de Cloud Bigtable y Cloud Bigtable Admin:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de uso de servicios (roles/serviceusage.serviceUsageAdmin), que contiene el serviceusage.services.enable permiso. Obtén información para otorgar roles.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

Otorga roles a tu cuenta de usuario. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/bigtable.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Reemplaza lo siguiente:

• PROJECT_ID: ID del proyecto
• USER_IDENTIFIER: Es el identificador de tu cuenta de usuario. Por ejemplo, [e-mail].
• ROLE: Es el rol de IAM que otorgas a tu cuenta de usuario.
1. Ejecuta el siguiente comando para instalar la cbt CLI :

   gcloud components install cbt

Crear una instancia de Bigtable.

1. Abre la página Crear instancia en la Google Cloud consola de.

   Crea una instancia

2. En Nombre de la instancia, ingresa Quickstart instance.

3. En ID de instancia, ingresa quickstart-instance.

4. Haz clic en Continuar.

5. En Tipo de almacenamiento, selecciona SSD.

6. Haz clic en Continuar.

7. En ID de clúster, ingresa quickstart-instance-c1.

8. En Región, selecciona una región cercana.

9. En Zona, selecciona Cualquiera.

10. En Modo de ajuste de escala de nodos, elige Asignación manual.

11. En Cantidad, selecciona 1.

12. Haz clic en Crear para crear la instancia.

Conéctate a la instancia

1. Configura la CLI de cbt para que use tu instancia y proyecto. Para ello crea un archivo .cbtrc y reemplaza PROJECT_ID por el ID del proyecto en el que creaste la instancia de Bigtable:

   echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
   

2. Verifica que hayas configurado correctamente el archivo .cbtrc:

   cat ~/.cbtrc

   La terminal muestra el contenido del archivo .cbtrc, que es similar a lo siguiente:

   project = PROJECT_ID
   instance = quickstart-instance

   Ahora puedes usar la cbt CLI con tu instancia.

Lee y escribe datos

Bigtable almacena datos en tablas, las cuales contienen filas. Cada fila se identifica con una clave de fila.

Los datos de una fila se organizan en familias de columnas, que son grupos de columnas. Un calificador de columna identifica una columna individual dentro de una familia.

Puede haber varias celdas con marcas de tiempo en la intersección de una fila y una columna.

1. Crea una tabla con el nombre my-table.

   cbt createtable my-table

2. Genera una lista de tus tablas:

   cbt ls

   El comando muestra un resultado similar a este:

       my-table

3. Agrega una familia de columnas con el nombre cf1:

   cbt createfamily my-table cf1

4. Genera una lista de tus familias de columnas:

   cbt ls my-table

   El comando muestra un resultado similar al siguiente:

       Family Name     GC Policy
       -----------     ---------
       cf1             <never>

5. Ingresa los valores test-value1 y test-value2 en la fila r1 mediante la familia de columnas cf1 y el calificador de columna c1:

   cbt set my-table r1 cf1:c1=test-value1
     cbt set my-table r1 cf1:c1=test-value2
   

6. Usa el comando cbt read para leer los datos que agregaste a la tabla:

   cbt read my-table

   La shell muestra un resultado similar al siguiente:

       ----------------------------------------
       r1
         cf1:c1                                   @ 2023/03/22-06:56:11.323000
           "test-value1"
         cf1:c1                                   @ 2023/03/22-06:56:04.361000
           "test-value2"

   Se almacenan dos valores con marca de tiempo para la misma columna en la fila r1.

   Nota: En esta guía de inicio rápido, configuras solo dos celdas, pero Bigtable te permite configurar hasta 10,000 celdas en una solicitud de escritura.

Limpia

Para evitar que se apliquen cargos a tu Google Cloud cuenta por los recursos que usaste en esta guía de inicio rápido, borra la instancia. Si borras el archivo .cbtrc, estarás listo para trabajar en un proyecto diferente.

1. Borra la tabla my-table:

   cbt deletetable my-table

2. Borra la instancia:

   cbt deleteinstance quickstart-instance

3. Borra el archivo .cbtrc:

   rm ~/.cbtrc

4. Opcional: Revoca credenciales desde gcloud CLI:

   gcloud auth revoke

¿Qué sigue?

• Trabaja en un codelab de Bigtable.
• Consulta la documentación de referencia de la CLI de cbt.
• Consulta el código fuente de muestra para un caso de uso de detección de fraude.
• Escribe una aplicación Hello World en C#, C++, Go, Java, Node.js, PHP, Python, Ruby o el cliente de HBase para Java.