SDK Go: database gestiti

c.Databases gestisce i database gestiti di Square Cloud (MongoDB, MySQL, PostgreSQL e Redis). Ogni metodo accetta prima ctx e, tranne Create e StatusAll, poi l’id del database. Per elencare i tuoi database, usa c.Account.Me: il suo slice Databases contiene ogni database che la chiave può vedere. L’hosting di database richiede un piano Standard, Pro o Enterprise. Ogni snippet qui sotto funziona da solo all’interno di questo programma: incollane uno alla volta in main ed esegui goimports (vedi Eseguire gli esempi).

package main

import (
	"context"
	"os"

	"github.com/squarecloudofc/sdk-api-go/v3"
)

var (
	ctx        = context.Background()
	c          = squarecloud.New(os.Getenv("SQUARECLOUD_API_KEY"))
	databaseID = "abc123def456abc123def456"
)

func main() {
	// Paste one snippet here, then run goimports.
}

Creare un database

db, err := c.Databases.Create(ctx, squarecloud.DatabaseCreate{
	Name:    "my-db",
	Type:    squarecloud.DatabasePostgres, // DatabaseMongo, DatabaseMySQL, DatabaseRedis, DatabasePostgres
	Version: "17",                         // a full version or a prefix
	Memory:  1024,                         // MB
})
if err != nil {
	log.Fatal(err)
}

fmt.Println(db.ID, db.ConnectionURL, db.Cluster)
fmt.Println(db.Password) // shown only here: save it
if db.Certificate != nil {
	fmt.Println(*db.Certificate) // base64 PEM (private key, then certificate)
}

Campo	Descrizione
`Name` (`name`)	Da 1 a 32 caratteri
`Type` (`type`)	`DatabaseMongo`, `DatabaseMySQL`, `DatabaseRedis` o `DatabasePostgres` (`mongo`, `mysql`, `redis`, `postgres`)
`Version` (`version`)	Una versione completa o un prefisso come `"8"`
`Memory` (`memory`)	MB, un `int`. Almeno 512 per Redis e 1024 per gli altri

Il risultato è un DatabaseCreated con ID, Name, Memory, CPU (float64), Type, Password, Certificate (*string, nil quando l’API non ne invia), ConnectionURL (connection_url) e Cluster. La password e il certificato vengono restituiti solo da Create (e da ResetCredentials). Senza una scadenza su ctx, la chiamata attende almeno 2 minuti prima di andare in timeout.

Status	Codice	Quando
400	`INVALID_NAME`	Il nome non è compreso tra 1 e 32 caratteri
400	`INVALID_DATABASE_TYPE`, `INVALID_DATABASE_VERSION`	Tipo sconosciuto o versione non supportata
400	`INVALID_MEMORY`	`memory` non è un numero intero (una frazione o una stringa). `Memory` è un `int`, quindi l’SDK Go non ne invia mai uno
400	`INSUFFICIENT_MEMORY`	`Memory` è sotto il minimo del motore o supera la memoria disponibile
400	`CLUSTER_SELECTION_FAILED`	Nessun cluster aveva capacità sufficiente
400 / 500	`DATABASE_CREATION_FAILED`	Il provisioning è fallito
403	`UPGRADE_REQUIRED`	Il piano non include l’hosting di database
503	`CLUSTER_MAINTENANCE_TRY_LATER`	Il provisioning è sospeso per manutenzione

Recuperare un database

db, err := c.Databases.Get(ctx, databaseID)
if err != nil {
	log.Fatal(err)
}

fmt.Println(db.ID, db.Name, db.Type, db.RAM, db.Port, db.Cluster, db.CreatedAt)

Aggiornare un database

Update(ctx, databaseID, squarecloud.DatabaseUpdate{Name, RAM}) rinomina o ridimensiona un database. I campi a valore zero non vengono inviati; impostane almeno uno (altrimenti 400 NO_UPDATE_DATA).

if err := c.Databases.Update(ctx, databaseID, squarecloud.DatabaseUpdate{Name: "orders", RAM: 2048}); err != nil {
	log.Fatal(err)
}

Avvio e arresto

if err := c.Databases.Start(ctx, databaseID); err != nil {
	log.Fatal(err)
}
if err := c.Databases.Stop(ctx, databaseID); err != nil {
	log.Fatal(err)
}

Come le chiamate del ciclo di vita delle app, senza una scadenza su ctx attendono almeno 2 minuti, e un rifiuto è un 409 con un codice e un messaggio vuoto: CONTAINER_ALREADY_STARTED, CONTAINER_ALREADY_STOPPED, CONTAINER_NOT_FOUND, CONTAINER_INSUFFICIENT_DISK_SPACE, CONTAINER_NETWORK_CONFLICT o ACTION_FAILED. Mentre è in corso il ripristino di uno snapshot, producono 403 RESTORE_IN_PROGRESS.

Stato e metriche

Status(ctx, databaseID) restituisce valori formattati; StatusRaw(ctx, databaseID) restituisce numeri. StatusAll(ctx) restituisce un riepilogo per ogni database. Metrics(ctx, databaseID) restituisce le ultime 24 ore, un punto ogni 5 minuti, dal più recente.

status, err := c.Databases.Status(ctx, databaseID)
if err != nil {
	log.Fatal(err)
}
fmt.Println(status.Running, status.CPU, status.RAM) // true "0.5%" "120.4MB"

raw, err := c.Databases.StatusRaw(ctx, databaseID)
if err != nil {
	log.Fatal(err)
}
fmt.Println(raw.CPU, raw.RAM) // 0.5 120.4

items, err := c.Databases.StatusAll(ctx)
if err != nil {
	log.Fatal(err)
}
for _, it := range items {
	fmt.Println(it.ID, it.Running, it.CPU, it.RAM) // CPU and RAM only while running
}

points, err := c.Databases.Metrics(ctx, databaseID)
if err != nil {
	log.Fatal(err)
}
if len(points) > 0 {
	fmt.Println(points[0].Date, points[0].CPU, points[0].RAM)
}

I campi di stato sono gli stessi dello stato delle app.

Credenziali

Certificate(ctx, databaseID) restituisce il certificato TLS come PEM codificato in base64. ResetCredentials(ctx, databaseID, reset) rigenera la password (squarecloud.ResetPassword, restituisce quella nuova) o il certificato (squarecloud.ResetCertificate, restituisce ""). Il database deve essere in esecuzione (400 DATABASE_NOT_RUNNING).

certificate, err := c.Databases.Certificate(ctx, databaseID)
if err != nil {
	log.Fatal(err)
}
pem, err := base64.StdEncoding.DecodeString(certificate)
if err != nil {
	log.Fatal(err)
}
if err := os.WriteFile("database.pem", pem, 0o600); err != nil {
	log.Fatal(err)
}

password, err := c.Databases.ResetCredentials(ctx, databaseID, squarecloud.ResetPassword)
if err != nil {
	log.Fatal(err)
}
fmt.Println(password) // the new password: save it

if _, err := c.Databases.ResetCredentials(ctx, databaseID, squarecloud.ResetCertificate); err != nil {
	log.Fatal(err)
}

Eliminare un database

if err := c.Databases.Delete(ctx, databaseID); err != nil {
	log.Fatal(err)
}

L’eliminazione è permanente. Crea prima uno snapshot se potresti aver ancora bisogno dei dati.

Snapshot

c.Databases.Snapshots ha gli stessi List, Create e Restore delle app. Vedi Snapshot.

Prossimi passi

Workspace

Condividi le app con il tuo team.

Riferimento API dei database

Gli endpoint REST dietro questi metodi.

Database dalla CLI

Le stesse azioni dal terminale.

CLI

VS Code

SDKs

SDK Go: database gestiti

Creare un database

Recuperare un database

Aggiornare un database

Avvio e arresto

Stato e metriche

Credenziali

Eliminare un database

Snapshot

Prossimi passi

Workspace

Riferimento API dei database

Database dalla CLI

​Creare un database

​Recuperare un database

​Aggiornare un database

​Avvio e arresto

​Stato e metriche

​Credenziali

​Eliminare un database

​Snapshot

​Prossimi passi

Workspace

Riferimento API dei database

Database dalla CLI

Creare un database

Recuperare un database

Aggiornare un database

Avvio e arresto

Stato e metriche

Credenziali

Eliminare un database

Snapshot

Prossimi passi