Come fare il deploy del tuo primo database gestito

Introduzione

Questo tutorial ti porta da zero a un database live e connesso in pochi minuti: crea l’istanza dalla dashboard, recupera la sua connection string e connettiti da codice tuo.

Prerequisiti

Account Square Cloud: Crea il tuo account tramite la pagina di registrazione.
Piano Standard o superiore attivo: I database gestiti richiedono un piano Standard o superiore attivo. Consulta i piani disponibili e scegli quello adatto al tuo carico di lavoro.

Passo 1: Scegli un motore

Square Cloud offre quattro motori di database gestiti, già configurati per la connessione e pronti all’uso:

Motore	Versione
PostgreSQL	17.x.x
MongoDB	8.x.x
MySQL	9.x.x
Redis	7.4.x

Questo tutorial usa PostgreSQL, ma lo stesso flusso della dashboard si applica a ogni motore sopra elencato.

Passo 2: Crea il database

Crea una nuova istanza di database

Vai alla pagina Databases e clicca sul pulsante “Create Database”.

Configura la tua istanza di database

Seleziona PostgreSQL (o il motore scelto al Passo 1) e compila le informazioni richieste, come il nome del database e la RAM.

Completa la creazione dell'istanza

Clicca sul pulsante “Create” e attendi che il database venga creato.

Passo 3: Recupera la connection string

Una volta pronto il tuo database, aprilo dalla pagina Databases. I dettagli di connessione — host, porta, username, password e URL di connessione — sono mostrati nella dashboard del database, insieme al certificato TLS di cui avrai bisogno per connetterti.

I database di Square Cloud accettano solo connessioni SSL/TLS. Consulta come mi connetto al mio database per capire come il certificato viene usato dai diversi client.

Passo 4: Connettiti dal tuo codice

Con la connection string a disposizione, connettiti usando il client PostgreSQL del tuo linguaggio.

Node.js
Python

Installa il pacchetto pg:

npm install pg

Connettiti e verifica con una semplice query:

index.js

import fs from "node:fs";
import { Client } from "pg";

const cert = fs.readFileSync("certificate.pem").toString();

const client = new Client({
  connectionString: process.env.DATABASE_URL, // postgresql://user:password@host:port/dbname
  ssl: { ca: cert, cert: cert, key: cert },
});

await client.connect();
const result = await client.query("SELECT 1");
console.log("Connected! Result:", result.rows[0]);
await client.end();

Installa psycopg2:

pip install psycopg2-binary

Connettiti e verifica con una semplice query:

main.py

import os
import psycopg2

conn = psycopg2.connect(
    os.environ["DATABASE_URL"],  # postgresql://user:password@host:port/dbname
    sslmode="verify-ca",
    sslrootcert="certificate.pem",
    sslcert="certificate.pem",
    sslkey="certificate.pem",
)
cur = conn.cursor()
cur.execute("SELECT 1")
print("Connected! Result:", cur.fetchone())
cur.close()
conn.close()

Se la query restituisce un risultato invece di generare un errore di connessione, la tua applicazione sta comunicando correttamente con il database.

Non inserire mai la connection string direttamente nel codice sorgente. Impostala come variabile d’ambiente (DATABASE_URL) tramite il tuo file di configurazione o la dashboard, così le credenziali non finiscono mai nel tuo repository.

Il tuo database è online

Ora hai un database gestito in esecuzione e raggiungibile dal tuo codice. Da qui:

Fai il deploy di un'app che lo usa

Ospita su Square Cloud l’applicazione che si connette a questo database.

Snapshot

Crea e ripristina snapshot del database dalla CLI.

Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema — la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.

Tutorial

Bots

Progetti pronti

Database

APIs

Sito web

Guide alla migrazione

Come fare il deploy del tuo primo database gestito

Introduzione

Prerequisiti

Passo 1: Scegli un motore

Passo 2: Crea il database

Passo 3: Recupera la connection string

Passo 4: Connettiti dal tuo codice

Il tuo database è online

Fai il deploy di un'app che lo usa

Snapshot

Contattaci

​Introduzione

​Prerequisiti

​Passo 1: Scegli un motore

​Passo 2: Crea il database

​Passo 3: Recupera la connection string

​Passo 4: Connettiti dal tuo codice

​Il tuo database è online

Fai il deploy di un'app che lo usa

Snapshot

​Contattaci

Introduzione

Prerequisiti

Passo 1: Scegli un motore

Passo 2: Crea il database

Passo 3: Recupera la connection string

Passo 4: Connettiti dal tuo codice

Il tuo database è online

Contattaci