En esta página, se describe cómo configurar una instancia de Cloud SQL nueva con Cloud Tools for PowerShell. Consulta la referencia del cmdlet de Cloud Tools for PowerShell a fin de obtener más información sobre los cmdlets.
Para la mayoría de los inicializadores, puedes especificar un ID del proyecto, pero si lo omites, la configuración predeterminada de PowerShell es lo que se especifique en la configuración de la CLI de gcloud activa.
Configura una instancia nueva
Una instancia de Cloud SQL es una base de datos de MySQL que se ejecuta en la nube. Puedes usar instancias de Cloud SQL para almacenar, replicar y proteger las bases de datos de MySQL. Puedes configurar el comportamiento de la instancia, como cuándo y dónde se replicarán los datos o cuándo es aceptable dar mantenimiento a la base de datos.
A fin de crear y, luego, iniciar una base de datos de Cloud SQL, primero debes especificar la configuración y los ajustes. Para hacerlo con Cloud Tools for PowerShell, usa los cmdlets New-GcSqlSettingConfig y New-GcSqlInstanceConfig.
Los parámetros de configuración de SQL, como el registro, los períodos de mantenimiento, etc., son parámetros del compilador New-GcSqlSettingConfig. La configuración a nivel de instancia, como las características de hardware de la máquina de la base de datos, se establece mediante el objeto SqlInstanceConfig o las marcas en el compilador New-GcSqlInstanceConfig.
No especificar parámetros hace que se cree la instancia de Cloud SQL más básica mediante el nivel "db-n1-standard-1":
$setting = New-GcSqlSettingConfig
$instance = New-GcSqlInstanceConfig `
"mynewinstance" -SettingConfig $setting
Para obtener más información sobre los niveles y precios, consulta el tema Precios de Cloud SQL.
Para obtener información sobre las opciones de configuración, usa Get-Help New-GcSqlSettingConfig o consulta la documentación del objeto DatabaseInstance.
Crea una instancia nueva
Una vez que hayas realizado la configuración descrita en la sección anterior, ahora puedes crear la base de datos de Cloud SQL con el cmdlet Add-GcSqlInstance:
Add-GcSqlInstance $instance
Crear una instancia nueva puede tardar alrededor de un minuto. Una vez que el proceso finaliza, el cmdlet muestra un objeto DatabaseInstance que describe la instancia que se acaba de crear. Puedes ir a la consola para ver la instancia.
A partir de este momento, puedes administrar la base de datos como se describe en la documentación de Cloud SQL.
Crea una instancia de réplica de lectura
Con las instancias de réplica de lectura, se proporciona funcionalidad de replicación para los datos en una instancia principal. Después de la creación, se pueden convertir en una conmutación por error o en su propia instancia independiente. Los datos se pueden leer desde instancias de réplica de lectura, pero pueden estar un poco desactualizados, según las replicaciones semisíncronas. Si creas una copia de seguridad de los datos en varias regiones a través de las instancias de réplica de lectura, los datos aún se podrán leer en caso de que haya una interrupción.
Con el siguiente fragmento de código, se crea una réplica de lectura mynewreplica de la instancia principal gootoso que ya existe. El fragmento usa el compilador New-GcSqlInstanceReplicaConfig. Esto establece opciones de configuración específicas para las instancias de réplica de lectura, como la velocidad con la que replican datos o si lo hacen desde una instancia externa:
$setting = New-GcSqlSettingConfig "db-n1-standard-1"
$replicaConfig = New-GcSqlInstanceReplicaConfig
$instance = New-GcSqlInstanceConfig "mynewreplica" `
-SettingConfig $setting `
-ReplicaConfig $replicaConfig `
-MasterInstanceName "gootoso"
Add-GcSqlInstance $instance
Para obtener más información sobre los requisitos de una réplica de lectura, consulta Requisitos y sugerencias para configurar replicaciones.
A fin de ver una demostración de cómo promover una réplica de lectura para que sea una instancia de conmutación por error o independiente, consulta Administra replicaciones de instancias.
Crea una instancia de réplica de conmutación por error
Cloud SQL proporciona una configuración de alta disponibilidad para las instancias mediante el uso de réplicas de conmutación por error. Con estas, se usa la replicación semisíncrona para replicar todos los cambios en los datos de la instancia principal. Si la zona de una instancia principal experimenta una interrupción, la réplica de conmutación por error se activa y toma el control. Por esta razón, la réplica debe estar en una zona diferente a la de la instancia principal.
Con el siguiente fragmento de código, se crea una réplica nueva de conmutación por error myfailover para la instancia principal gootoso. La instancia de réplica se crea de la misma manera que se menciona anteriormente, con los cmdlets de configuración. Sin embargo, observa la adición de la marca -FailoverTarget.
$setting = New-GcSqlSettingConfig "db-n1-standard-1"
$replicaConfig = New-GcSqlInstanceReplicaConfig -FailoverTarget
$instance = New-GcSqlInstanceConfig "myfailover" `
-SettingConfig $setting `
-ReplicaConfig $replicaConfig `
-MasterInstanceName "gootoso"
Add-GcSqlInstance $instance
Ten en cuenta que las instancias de réplica afectan la facturación de la misma manera que las instancias normales.