La CLI de gcloud proporciona un emulador local en la memoria que puedes usar para desarrollar y probar tus aplicaciones de forma gratuita sin crear un proyecto de Google Cloud ni cuenta de facturación de Google Cloud. Como el emulador almacena datos solo en la memoria, todo el estado, incluidos los datos, el esquema y las configuraciones, se pierde cuando se reinicia. El emulador ofrece las mismas APIs que el servicio de producción de Spanner y está para el desarrollo y las pruebas locales, no para implementaciones de producción.
El emulador admite los dialectos GoogleSQL y PostgreSQL. Admite todos los lenguajes de las bibliotecas cliente. También puedes usar el emulador con el Google Cloud CLI y las APIs de REST
El emulador también está disponible como un proyecto de código abierto en GitHub.
Limitaciones y diferencias
El emulador no admite lo siguiente:
- TLS/HTTPS, autenticación, IAM, permisos o funciones
- modos de consulta
PLAN
oPROFILE
Solo es compatible conNORMAL
. - La sentencia
ANALYZE
El emulador acepta, pero lo ignora. - Cualquiera de los registros de auditoría y las herramientas de supervisión
El emulador también difiere del servicio de producción de Spanner en de la siguiente manera:
- Es posible que los mensajes de error no sean coherentes entre el emulador y el servicio de producción.
- El rendimiento y la escalabilidad del emulador no son comparables con el servicio de producción.
- Las transacciones de lectura o de escritura y los cambios de esquema bloquearán toda la base de datos para obtener acceso exclusivo hasta que se completen.
- El DML particionado y la consulta de partición son compatibles, pero el emulador no verifica si las declaraciones se pueden particionar. Esto significa que una declaración de DML particionado o de consulta de partición podría ejecutarse en el emulador, pero puede fallar en el servicio de producción con un error de declaración no particionable.
Para obtener una lista completa de las API y características compatibles, no compatibles y parcialmente compatibles, consulta el archivo README de GitHub.
Cómo instalar y ejecutar el emulador
Las dos formas más comunes de ejecutar el emulador son con gcloud CLI y Docker. Puedes elegir la forma adecuada para el desarrollo de tu aplicación y en el flujo de trabajo de prueba.
gcloud CLI
Para los usuarios de Windows y MacOS, el emulador requiere que Docker esté instalado en tu sistema y disponible en la ruta del sistema.
Actualiza
gcloud
para obtener la versión más reciente:gcloud components update
Inicia el emulador:
gcloud emulators spanner start
Si el emulador aún no está instalado, se te solicitará que realices la descarga y la instalación del objeto binario para el emulador.
De forma predeterminada, el emulador aloja dos extremos locales:
localhost:9010
para las solicitudes de gRPC ylocalhost:9020
para las solicitudes de REST.Para obtener más detalles sobre este comando, consulta emuladores spanner de gcloud.
Docker
Asegúrate de que Docker esté instalado en tu sistema y esté disponible en la ruta del sistema.
Obtén la imagen más reciente del emulador:
docker pull gcr.io/cloud-spanner-emulator/emulator
Inicia el emulador:
docker run -p 9010:9010 -p 9020:9020 gcr.io/cloud-spanner-emulator/emulator
Este comando ejecuta el emulador y asigna los puertos del contenedor al los mismos puertos en el host local. Tendrás dos extremos locales:
localhost:9010
para las solicitudes de gRPC ylocalhost:9020
para las solicitudes de REST.
Usa gcloud CLI con el emulador
Para usar el emulador con gcloud, debes inhabilitar la autenticación y anular el extremo.
Te recomendamos crear una configuración de gcloud por separado, para que puedas cambiar entre el emulador y el servicio de producción con rapidez. Para crear y activar una configuración de emulador, ejecuta lo siguiente:
gcloud config configurations create emulator
gcloud config set auth/disable_credentials true
gcloud config set project your-project-id
gcloud config set api_endpoint_overrides/spanner http://localhost:9020/
Una vez configurado, tus comandos de gcloud se enviarán al emulador en lugar del servicio de producción. Para verificar esto, crea una instancia con la configuración de la instancia del emulador:
gcloud spanner instances create test-instance \
--config=emulator-config --description="Test Instance" --nodes=1
Para cambiar entre el emulador y la configuración predeterminada, ejecuta lo siguiente:
gcloud config configurations activate [emulator | default]
Cómo usar las bibliotecas cliente con el emulador
Puedes usar las versiones compatibles de las bibliotecas cliente con el emulador si configuras la variable de entorno SPANNER_EMULATOR_HOST
.
Existen muchas maneras de hacerlo. Por ejemplo:
Linux/macOS
export SPANNER_EMULATOR_HOST=localhost:9010
Windows
set SPANNER_EMULATOR_HOST=localhost:9010
O con gcloud env-init:
Linux/macOS
$(gcloud emulators spanner env-init)
Windows
gcloud emulators spanner env-init > set_vars.cmd && set_vars.cmd
Cuando se inicia la aplicación, la biblioteca cliente busca SPANNER_EMULATOR_HOST
automáticamente y se conecta al emulador si se está ejecutando.
Una vez que se configure SPANNER_EMULATOR_HOST
, puedes probar el emulador siguiendo las guías de introducción que se indican a continuación. Puedes ignorar las instrucciones relacionadas con la creación, la autenticación y las credenciales del proyecto, ya que no son necesarias para usar el emulador.
Primeros pasos con C#. Debes establecer las opciones de la cadena de conexión. Consulta las instrucciones adicionales para C#.
Versiones compatibles
En la siguiente tabla, se enumeran las versiones de las bibliotecas cliente compatibles con el emulador.
Biblioteca cliente | Versión mínima |
---|---|
C++ | v0.9.x+ |
C# | v3.1.0+ |
Comienza a usarlo | v1.5.0+ |
Java | v1.51.0+ |
Node.js | v4.5.0+ |
PHP | v1.25.0+ |
Python | v1.15.0+ |
Ruby | v1.13.0+ |
Instrucciones adicionales para C#
En el caso de la biblioteca cliente de C#, también debes especificar la opción emulatordetection
en la cadena de conexión.
A diferencia de las otras bibliotecas cliente, C# ignora la variable de entorno SPANNER_EMULATOR_HOST
de forma predeterminada. A continuación, te indicamos cómo hacerlo:
var builder = new SpannerConnectionStringBuilder
{
DataSource = $"projects/{projectId}/instances/{instanceId}/databases/{databaseId}";
EmulatorDetection = "EmulatorOnly"
};