Crea e connetti un 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
MongoDB	8
MySQL	9
Redis	8

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 e abilita i moduli ES, usati dall’esempio qui sotto (import e await di primo livello):

npm install pg
npm pkg set type=module

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) nelle Variabili d’ambiente della tua applicazione nella dashboard, oppure con il comando CLI squarecloud app env set "DATABASE_URL=<connection-url>" --app <appID> (vedi le variabili d’ambiente nella CLI), così le credenziali non finiscono mai nel tuo repository. Poi riavvia l’applicazione: legge le variabili d’ambiente all’avvio. Consulta Variabili d’ambiente.

Tieni certificate.pem nello ZIP della tua applicazione, perché il codice lo legge dal disco, ma fuori da qualsiasi repository pubblico.

Prossimi passi

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.

Errori di connessione al database

Risolvi errori SSL/TLS, di timeout e di accesso.

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.

Bots

Siti web

API e backend

Database

App self-hosted

Guide

Guide alla migrazione

Crea e connetti un 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

Prossimi passi

Fai il deploy di un'app che lo usa

Errori di connessione al database

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

​Prossimi passi

Fai il deploy di un'app che lo usa

Errori di connessione al database

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

Prossimi passi

Contattaci