Hello World en Python
En este ejemplo, se usa una aplicación muy simple llamada Hello World y escrita en Python, y se muestra cómo realizar las siguientes acciones:
- Configura la autenticación
- Conectarse a una instancia de Bigtable
- Crear una tabla nueva
- Escribir datos en la tabla
- Volver a leer datos
- Borrar la tabla
Configura la autenticación
Para usar las muestras de Python de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ejecuta la muestra
En este ejemplo, se usa el paquete de Bigtable de la biblioteca cliente de Google Cloud para Python para comunicarse con Bigtable. El paquete de Bigtable es la mejor opción para aplicaciones nuevas. Si necesitas transferir una carga de trabajo existente de HBase a Bigtable, consulta el ejemplo de “Hello World” en el que se usa el paquete HappyBase.
Para ejecutar este programa de muestra, sigue las instrucciones de la muestra en GitHub.
Usa la biblioteca cliente de Cloud con Bigtable
La aplicación de muestra se conecta con Bigtable y demuestra algunas operaciones simples.
Cómo instalar e importar la biblioteca cliente
Usa el PIP para instalar los paquetes de Python necesarios en un entorno virtualenv. La muestra incluye el archivo de requisitos en el que se definen los paquetes necesarios.
Importa los módulos.
Cliente asíncrono
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cliente de sincronización
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Conéctate a Bigtable
Conéctate a Bigtable con bigtable.Client
.
Cliente asíncrono
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cliente de sincronización
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Crea una tabla
Crea una instancia de un objeto de tabla con Instance.table()
. Crea una familia de columnas y establece su política de recolección de elementos no utilizados; luego, pasa la familia de columnas a Table.create()
para crear la tabla.
Escribe filas en una tabla
Recorre una lista de strings de saludos para crear filas nuevas en la tabla.
En cada iteración, usa Table.row()
para definir una fila y asignarle una clave de fila, llama a Row.set_cell()
a fin de establecer un valor para la celda actual y adjunta la fila nueva a un arreglo de filas.
Por último, llama a Table.mutate_rows()
para agregar las filas a la tabla.
Cliente asíncrono
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cliente de sincronización
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Crea un filtro
Antes de leer los datos que escribiste, crea un filtro con row_filters.CellsColumnLimitFilter()
para limitar los datos que muestra Bigtable. El filtro le indica a Bigtable que muestre solo la celda más reciente de cada columna, incluso si la tabla contiene celdas más antiguas que aún no se quitaron durante la recolección de elementos no utilizados.
Cliente asíncrono
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cliente de sincronización
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Lee una fila por su clave
Llama al método Table.read_row()
de la tabla a fin de obtener una referencia de la fila con una clave de fila específica; para eso, pasa la clave y el filtro, y así obtendrás una versión de cada valor en esa fila.
Cliente asíncrono
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cliente de sincronización
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Analiza todas las filas de una tabla
Usa Table.read_rows()
para leer un rango de filas de una tabla.
Cliente asíncrono
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cliente de sincronización
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Borra una tabla
Borra una tabla con Table.delete()
.
Revisión general
El ejemplo completo sin comentarios.
Cliente asíncrono
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cliente de sincronización
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Bigtable, consulta Bibliotecas cliente de Bigtable.
Para autenticarte en Bigtable, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.