Crea una instancia de prueba gratuita y una aplicación de ejemplo de Spanner

Nota: Una instancia de prueba gratuita de Spanner admite funciones de la edición Estándar y de la edición Enterprise, como las funciones de distancia vectorial del KNN, la búsqueda en el texto completo y Spanner Graph. Para obtener más información, consulta la descripción general de las ediciones de Spanner.

En esta guía de inicio rápido, se muestra cómo usar una instancia de prueba gratuita de Spanner y una aplicación de muestra. Para obtener más información, consulta la descripción general de las instancias de prueba gratuitas de Spanner.

Comienza con una instancia de prueba gratuita

Cualquier persona que tenga una Cuenta de Google y que haya habilitado la Facturación de Cloud en su proyecto puede acceder a una instancia de prueba gratuita de Spanner de 90 días. No se te cobrará a menos que elijas actualizar tu instancia de prueba gratuita a una instancia pagada.

Puedes crear una instancia de prueba gratuita con la consola de Google Cloud o Google Cloud CLI.

Nota: Solo puedes crear una instancia de prueba gratuita por ciclo de vida del proyecto y un máximo de cinco instancias de prueba gratuita por cuenta de Facturación de Cloud.

Antes de comenzar

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Spanner.

   Ir a Spanner

2. Selecciona o crea un proyecto de Google Cloud si aún no lo hiciste.

3. Si la Facturación de Cloud ya está habilitada para tu proyecto, continúa con la sección Crea una instancia de prueba gratuita.

   Si la Facturación de Cloud no está habilitada para tu proyecto, vincula una cuenta de Facturación de Cloud existente o crea una nueva. Google usa esta información de pago para verificar tu identidad. No te cobraremos por tu instancia de Spanner a menos que actualices explícitamente tu cuenta de Facturación de Cloud a una cuenta pagada y actualices tu instancia de prueba gratuita de Spanner a una instancia pagada.

   a. Haz clic en Ir a la facturación.

   b. Luego, haz clic en Vincular una cuenta de facturación.

   Nota: Si eres un cliente nuevo de Google Cloud , también puedes ser apto para la prueba gratuita de 90 días y $300 deGoogle Cloud , que ofrece $300 en créditos gratuitos de Facturación de Cloud para pagar cualquier recurso de Google Cloud. La instancia de prueba gratuita de Spanner se suma a los $300 en créditos de prueba gratuita que ofrece la Google Cloud prueba gratuita, y no necesitas usar ningún crédito gratuito de Facturación de Cloud para crear una instancia de prueba gratuita.

   c. Sigue los pasos para crear una cuenta de facturación y, luego, vincúlala a tu proyecto.

   d. Después de habilitar la Facturación de Cloud para tu proyecto, ve a la página de Spanner.

   Ir a Spanner

   e. Haz clic en Crear instancia gratuita y continúa con Crea una instancia de prueba gratuita en la siguiente sección.

4. Opcional: Si ya creaste una instancia de Spanner en el proyecto, verás la siguiente página Instancias de Spanner.

   Haz clic en Crear instancia gratuita.

gcloud

Accede a tu cuenta de Google Cloud . 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

• Selecciona 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.
• Crea un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un proyecto de Google Cloud :

  gcloud projects create PROJECT_ID

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

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu proyecto de Google Cloud .

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

Si usas una shell local, crea credenciales de autenticación locales para tu cuenta de usuario:

gcloud auth application-default login

No es necesario que lo hagas si usas Cloud Shell.

Si se muestra un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

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

• Selecciona 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.
• Crea un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un proyecto de Google Cloud :

  gcloud projects create PROJECT_ID

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

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu proyecto de Google Cloud .

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

Si usas una shell local, crea credenciales de autenticación locales para tu cuenta de usuario:

gcloud auth application-default login

No es necesario que lo hagas si usas Cloud Shell.

Si se muestra un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

Crea una instancia de prueba gratuita

Consola de Google Cloud

En los siguientes pasos, se explica cómo crear una instancia de prueba gratuita con la consola deGoogle Cloud .

En la página Crea tu instancia de prueba gratuita, haz lo siguiente:

1. Ingresa el Nombre de la instancia que se mostrará en la consola de Google Cloud . La instancia debe ser única dentro de tu proyecto Google Cloud .
2. Ingresa el ID de instancia para identificar tu instancia de forma permanente. El ID de instancia también debe ser único dentro de tu proyecto de Google Cloud . No podrás cambiar el ID de instancia más adelante.

3. Selecciona una ubicación de configuración en el menú desplegable Región.

   La configuración de la instancia determina la ubicación geográfica en la que se almacena y replica tu instancia. Puedes crear una instancia de prueba gratuita en cualquiera de las configuraciones regionales de instancias de Spanner. Para obtener una lista completa de todas las configuraciones de instancias disponibles, consulta Configuraciones regionales, birregionales y multirregionales.

4. Haz clic en Crear instancia gratuita.

   Después de crear tu instancia de prueba gratuita, Spanner crea una base de datos de muestra para que explores y te familiarices con las funciones de Spanner. Para obtener más información, consulta la descripción general de las instancias de prueba gratuita.

gcloud

Para crear una instancia de prueba gratuita, usa el comando gcloud spanner instances create.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

Reemplaza lo siguiente:

• INSTANCE_ID: Es un identificador permanente que es único dentro de tu Google Cloud proyecto. No podrás cambiar el ID de la instancia más adelante.

• INSTANCE_CONFIG: Es un identificador permanente de la configuración de tu instancia, que define la ubicación geográfica de la instancia. Puedes crear una instancia de prueba gratuita en cualquiera de las configuraciones de instancias regionales de Spanner:

• INSTANCE_DESCRIPTION: Es el nombre que se mostrará para la instancia en la consola deGoogle Cloud . El nombre de la instancia debe ser único en tu proyecto deGoogle Cloud .

Por ejemplo, para crear una instancia de prueba gratuita llamada trial-instance con el nombre visible Trial Instance usando la configuración de instancia regional regional-us-east5, ejecuta el siguiente comando:

gcloud spanner instances create trial-instance --config=regional-us-east5 \
  --instance-type=free-instance --description="Trial Instance"

Nota: Usa el ID de la instancia, no el nombre visible, cuando hagas referencia a una instancia en los comandos de gcloud CLI.

Después de crear tu instancia de prueba gratuita, se te pedirá que sigas aprendiendo y explorando Spanner. Para ello, deberás iniciar un instructivo paso a paso que te enseñará a crear una base de datos con una aplicación de ejemplo. Para obtener más información, consulta Primeros pasos con una aplicación de ejemplo.

Comienza con una base de datos de muestra

Después de crear tu instancia de prueba gratuita con la Google Cloud consola, Spanner creará una base de datos de muestra para que explores y te familiarices con las funciones de Spanner.

Puedes acceder a la base de datos de muestra con la consola de Google Cloud .

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a la página Instancias

2. Haz clic en el nombre de la instancia de prueba gratuita.

3. Haz clic en el nombre de la base de datos de muestra.

Puedes ver las tablas y los datos en la base de datos de muestra. También puedes acceder a las consultas guardadas y verlas en la página de Spanner Studio. Las consultas guardadas muestran diferentes funciones y capacidades de Spanner.

Comienza con una aplicación de ejemplo

Spanner también ofrece una aplicación de ejemplo de código abierto para ayudarte a comenzar con la instancia de prueba gratuita de Spanner. La aplicación de ejemplo consta de un servicio de gRPC de backend respaldado por una base de datos de Spanner y un generador de cargas de trabajo que dirige el tráfico al servicio.

Puedes acceder a la aplicación de ejemplo con Google Cloud CLI.

gcloud

1. Completa los pasos que se describen en la configuración de gcloud, que abarca la creación y la configuración de un proyecto de Google Cloud predeterminado, la habilitación de la API de Cloud Spanner y la configuración de OAuth 2.0 para obtener credenciales de autenticación para usar la API de Cloud Spanner.

   Ejecuta el comando gcloud auth application-default login para configurar tu entorno de desarrollo local con credenciales de autenticación.

2. Ejecuta el comando gcloud spanner samples run para descargar la aplicación de ejemplo y, luego, inicia el servicio de gRPC de backend y el generador de cargas de trabajo para la aplicación de ejemplo determinada:

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. Para obtener más información y una lista de otros comandos disponibles para la aplicación de ejemplo, consulta la documentación de la CLI de gcloud.

Importación de tus propios datos

Puedes importar tus propios datos a una base de datos de Spanner con un archivo CSV, un archivo de volcado de MySQL o un archivo de volcado de PostgreSQL. Puedes subir un archivo local con Cloud Storage o directamente desde un bucket de Cloud Storage. Es posible que se apliquen cargos por subir un archivo local con Cloud Storage.

Si eliges usar un archivo CSV, también debes subir un archivo JSON independiente que contenga el esquema de la base de datos.

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a las instancias de Spanner

2. Selecciona la instancia en la que deseas crear la base de datos.

3. Haz clic en Importar mis propios datos.

4. Ingresa los siguientes valores:

   • Selecciona el Tipo de archivo.

   • Sube el archivo desde tu computadora o selecciona una ruta de acceso de bucket de Cloud Storage al archivo.

   • (Opcional) Si eliges usar un archivo CSV, también debes subir un archivo JSON independiente que contenga el esquema de la base de datos. El archivo JSON debe usar la siguiente estructura para definir el esquema:

     {
       "name": "COLUMN_NAME",
       "type": "TYPE",
       "notNull": NOT_NULL_VALUE,
       "primaryKeyOrder": PRIMARY_KEY_ORDER
     }

     Reemplaza lo siguiente:

     • COLUMN_NAME: Es el nombre de la columna en la tabla.

     • TYPE: Es el tipo de datos de la columna.

     • NOT_NULL_VALUE: Indica si la columna puede almacenar valores nulos o no (opcional). Las entradas válidas son true o false. La configuración predeterminada es false.

     • (Opcional) PRIMARY_KEY_ORDER: Determina el orden de la clave primaria. Establece el valor en 0 para una columna de clave no primaria. Establece el valor en un número entero, por ejemplo, 1 para una columna de clave primaria. Las columnas con números más bajos aparecen antes en una clave primaria compuesta.

     De forma predeterminada, el archivo CSV espera una coma para el delimitador de campo y una línea nueva para el delimitador de línea. Para obtener más información sobre el uso de delimitadores personalizados, consulta la referencia de gcloud alpha spanner databases import.

   • Selecciona una base de datos nueva o existente como destino.

5. Haz clic en Importar.

6. Spanner abre Cloud Shell y completa un comando que instala la herramienta de migración de Spanner y ejecuta el comando gcloud alpha spanner databases import. Presiona la tecla ENTER para importar datos a tu base de datos.x

Actualiza una instancia de prueba gratuita

En los siguientes pasos, se explica cómo actualizar tu instancia de prueba gratuita.

Consola de Google Cloud

1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

   Ir a la página Instancias

2. Haz clic en el nombre de la instancia de prueba gratuita.

3. En la página Descripción general de la instancia, haz clic en Editar instancia o Editar para actualizar.

4. En el campo Actualizar nombre de la instancia, ingresa un nombre más adecuado para tu instancia pagada, si corresponde.

5. Selecciona la opción de actualización. Puedes seleccionar una de las siguientes opciones:

   • Actualizar ahora
   • Actualizar automáticamente a la versión completa de la edición Enterprise después de que finalice la prueba
   • Recordarme más tarde

   En la sección Resumen, se proporciona una descripción de los costos de procesamiento y almacenamiento de la instancia pagada actualizada que seleccionaste.

6. Haz clic en Guardar para actualizar tu instancia de prueba gratuita.

gcloud

Para actualizar tu instancia de prueba gratuita a una instancia de la edición Enterprise pagada con la misma configuración de instancia, ejecuta el siguiente comando de gcloud spanner instances update:

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

Borra la instancia

Advertencia: Si borras una instancia, esta y todas sus bases de datos se quitarán de forma permanente. Esta acción no se puede deshacer. Además, no podrás crear otra instancia de prueba gratuita después de borrar la primera. Puedes crear una instancia de prueba gratuita por ciclo de vida del proyecto.

Consola de Google Cloud

1. Ve a la página Instancias de Spanner en la consola de Google Cloud .

   Ir a la página Instancias

2. Haz clic en el nombre de la instancia que deseas borrar.

3. En la página Descripción general de la instancia, haz clic en Borrar instancia.

4. Sigue las instrucciones para confirmar que deseas borrar la instancia.

5. Haz clic en Borrar.

gcloud

Para borrar tu instancia de prueba gratuita, usa el siguiente comando gcloud spanner instances delete:

gcloud spanner instances delete INSTANCE_ID

¿Qué sigue?

• Obtén más información sobre las instancias de prueba gratuita de Spanner.
• Obtén más información sobre las instancias y las bases de datos de Spanner.
• Para obtener detalles sobre los precios de Spanner después del período de prueba gratuita, consulta la página de precios.