La CLI de Spanner es una interfaz de línea de comandos (CLI) de la CLI de gcloud que te permite conectarte a tus bases de datos de Spanner e interactuar con ellas. Por ejemplo, puedes usar la CLI de Spanner para ejecutar instrucciones de GoogleSQL y automatizar tareas. En este documento se describe cómo configurar y usar la CLI de Spanner.
La CLI de Spanner se basa en el proyecto de código abierto spanner-cli.
Para ver una lista de todos los comandos de la CLI de Spanner compatibles, consulta los comandos de gcloud spanner cli.
Principales ventajas
Puedes usar la CLI de Spanner para realizar las siguientes acciones:
- Ejecuta comandos SQL de DDL, DML y DQL.
- Escribir y ejecutar instrucciones SQL en varias líneas.
- Usa metacomandos para realizar tareas del sistema, como ejecutar un comando de shell del sistema y ejecutar SQL desde un archivo.
- Automatiza las ejecuciones de SQL escribiendo una serie de instrucciones SQL en un archivo de secuencia de comandos y, a continuación, indica a la CLI de Spanner que ejecute la secuencia de comandos. Además, puedes redirigir la salida a un archivo de salida.
- Inicia una sesión interactiva de la CLI de Spanner, que te permite escribir directamente instrucciones SQL y metacomandos, y ver los resultados en la CLI.
Antes de empezar
Antes de usar la CLI de Spanner, asegúrate de que tienes el rol necesario y de que has instalado la CLI.
Roles obligatorios
Para obtener los permisos que necesitas para instalar Spanner, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Cloud Spanner (roles/spanner.admin) en Spanner.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.
También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.
Instalar la CLI de Spanner
La CLI de Spanner está disponible en la CLI de gcloud. Cuando ejecutas el comando gcloud spanner cli por primera vez, la interfaz de línea de comandos de gcloud instala automáticamente el componente de la interfaz de línea de comandos de Spanner.
Para instalar la CLI de Spanner manualmente, ejecuta el siguiente comando:
gcloud components install spanner-cli
Si la instalación mediante el comando de Google Cloud CLI no se realiza correctamente o no es viable en tu entorno de shell, Spanner proporciona paquetes Debian (.deb) y RPM (.rpm) independientes. Puedes usar estos paquetes para instalar manualmente en sistemas compatibles. Para instalarlo, ejecuta el siguiente comando:
apt-get install google-cloud-cli-spanner-cli
Opciones de configuración
La CLI de Spanner admite las siguientes opciones configurables:
- La opción de proyecto se obtiene mediante la propiedad
core/project. También puede especificar el proyecto con la opción