Atoms Cloud Database archivia e gestisce i dati strutturati su cui si basa la tua app, inclusi prodotti, prenotazioni, ordini, invii di moduli e contenuti generati dagli utenti. Nel modulo Database, puoi visualizzare ambienti e tabelle, cercare e modificare record, ispezionare le strutture delle tabelle e importare o esportare dati tramite file CSV.

Questa guida riguarda il database integrato in Atoms Cloud. Se il tuo progetto usa Supabase, consulta invece Connessione Supabase.

Apri un database

Prima di aprire un database, collega il tuo progetto a Atoms Cloud. Se non è ancora collegato, segui i passaggi di connessione in Atoms Cloud.

1. Apri il tuo progetto su un dispositivo desktop.
2. Nella stessa barra degli strumenti dello spazio di lavoro in cui si trova Visualizzatore App , seleziona Atoms Cloud.
3. Seleziona Database nella barra laterale di Atoms Cloud.
4. In Databases, seleziona quale database vuoi ispezionare. Le schede del database Development e Production vengono visualizzate quando sono disponibili per il progetto.

Ogni scheda del database mostra quanto spazio di archiviazione è utilizzato e la quantità totale disponibile. Usa Development durante la creazione e il test della tua app. Le modifiche apportate in Production possono influire sui dati dell'app live, quindi controlla sempre in quale ambiente ti trovi prima di apportare modifiche.

Scegli il database Development o Production.

Sfoglia e filtra i dati della tabella

1. Seleziona la scheda del database Development o Production, in base all'ambiente in cui vuoi lavorare.
2. Usa Search tables per trovare una tabella, oppure selezionane una direttamente dall'elenco. Ogni scheda della tabella mostra il numero di righe e se è di sola lettura.
3. Usa Search rows per cercare nella tabella corrente, oppure seleziona Filter per restringere i risultati usando uno o più campi.
4. Usa i controlli con le frecce di pagina sotto la tabella per visualizzare righe aggiuntive.
5. Per ispezionare la struttura della tabella, apri il menu ••• e seleziona Schema.

La vista Schema mostra il nome di ogni campo, il tipo di dati, lo stato della chiave, i requisiti, i vincoli e il valore predefinito. Seleziona Copy per copiare lo schema visualizzato.

Aggiungi, modifica o elimina righe

Quando hai trovato il database su cui vuoi apportare modifiche, puoi usare queste azioni per farlo:

Operazione	Come farlo
Aggiungi una riga	Apri ... e seleziona Add Row. Inserisci valori che corrispondano ai campi disponibili, quindi invia la riga.
Modifica una riga	Fai doppio clic su una cella e inserisci il nuovo valore. Seleziona Commit Changes per salvare tutte le modifiche in sospeso, oppure Discard per rimuoverle.
Elimina righe	Seleziona una o più righe, seleziona Delete, quindi conferma. L'eliminazione delle righe non può essere annullata.

L'aggiunta di una riga o la conferma di un'eliminazione applica immediatamente la modifica al database selezionato. Solo le modifiche inline delle celle richiedono di selezionare Commit Changes o Discard. Se hai modifiche in sospeso, confermale o scartale prima di aggiungere una riga, importare o esportare un file CSV, cambiare la ricerca o i filtri, oppure passare a un'altra pagina.

Se il progetto si trova in uno spazio di lavoro, solo gli Editors e il workspace owner possono modificare le righe nelle tabelle scrivibili. Se Atoms non riesce a rilevare una chiave primaria per una tabella, non puoi modificarne o eliminarne le righe perché Atoms non può identificare in modo affidabile i singoli record.

Rivedi una modifica di riga in sospeso, quindi conferma o scarta la modifica.

Crea tabelle o modifica lo schema

Apri l'ambiente database che vuoi aggiornare, quindi segui le istruzioni per la modifica che vuoi apportare:

Operazione	Come farlo
Crea una tabella	Nell'elenco delle tabelle, fai clic su ... e seleziona Create table. Inserisci un nome di tabella valido e i campi iniziali, quindi invia la richiesta. Attendi che l'Agente finisca, riapri Database e verifica la tabella.
Modifica lo schema	Fai clic sulla tabella a cui vuoi apportare modifiche, quindi fai clic su ... e seleziona Schema. Usa Add Field per creare un campo, oppure seleziona un campo idoneo per modificarlo. Puoi cambiarne il nome, il tipo, il valore predefinito, lo stato di obbligatorietà o l'unicità. Puoi anche contrassegnare per l'eliminazione i campi che non sono chiavi. Seleziona Submit Changes per inviare la richiesta all'Agente, oppure Discard per cancellare le modifiche in sospeso.

Solo il workspace owner può creare tabelle o modificare lo schema di una tabella.

L'invio di una richiesta di schema non significa che la migrazione sia completata. Attendi che l'Agente finisca, verifica il risultato in Database e poi testa la tua app. I campi della chiave primaria e le tabelle di sola lettura non possono essere modificati in questo modo.

Inserisci i dettagli del nuovo campo in Add Field.

Rivedi le modifiche di schema in sospeso prima di selezionare Submit Changes.

Importa o esporta dati CSV

Seleziona la tabella con cui vuoi lavorare, quindi segui le istruzioni per l'operazione pertinente:

Operazione	Come farlo
Importa CSV	Fai clic su ... e seleziona Import CSV. Scegli un file .csv non superiore a 10 MB, quindi controlla il nome del file, il numero stimato di righe, la tabella selezionata e l'ambiente prima di confermare. Le colonne del CSV devono corrispondere allo schema della tabella. Le righe importate vengono aggiunte immediatamente e non possono essere annullate automaticamente, quindi valuta di esportare prima i dati esistenti.
Esporta CSV	Fai clic su ... e seleziona Export CSV. Se una ricerca o un filtro è attivo, vengono esportate solo le righe corrispondenti. Altrimenti, vengono esportati tutti i dati della tabella corrente.

Solo il workspace owner può importare o esportare file CSV. Per le tabelle di sola lettura, Export CSV è l'unica opzione disponibile.

Autorizzazioni e tabelle protette

Azione	Chi può eseguirla	Requisiti aggiuntivi
Aggiungere, modificare o eliminare righe	Editor o workspace owner	La tabella deve essere scrivibile. La modifica e l'eliminazione delle righe richiedono anche informazioni sulla chiave primaria.
Creare tabelle o modificare schemi	Spazio di lavoro owner	I campi della chiave primaria e le tabelle di sola lettura non possono essere modificati.
Importare o esportare file CSV	Spazio di lavoro owner	I file CSV non possono essere importati in tabelle di sola lettura.

Le tabelle di sistema o utente protette possono mostrare un badge Read-only. Puoi visualizzarne i dati e ispezionarne lo schema quando disponibile, ma non puoi modificarne le righe o la struttura da questa pagina.

Risolvi i problemi comuni del database

“No databases found” o “No tables found”

Assicurati che Atoms Cloud sia collegato al progetto. Se è già collegato, conferma che la tua app includa una funzionalità che archivia dati persistenti. Se necessario, chiedi all'Agente di aggiungere la funzionalità supportata dal database. Una volta che l'Agente ha finito, riapri Database o seleziona Refresh.

Manca un'azione del database o non è disponibile

Controlla se la tabella ha un badge Read-only, quindi rivedi le autorizzazioni sopra per confermare che il tuo ruolo nello spazio di lavoro consenta l'azione. La modifica e l'eliminazione delle righe richiedono anche informazioni sulla chiave primaria.

Le modifiche di riga in sospeso possono impedire altre azioni. Seleziona Commit Changes o Discard prima di aggiungere una riga, importare o esportare un file CSV, cambiare la ricerca o i filtri, oppure passare a un'altra pagina.

Se l'azione non è ancora disponibile dopo questi controlli, contatta Support e includi il link del progetto o della Chat, l'ambiente, la tabella, il ruolo nello spazio di lavoro, l'azione tentata e il testo esatto dell'errore.

Non è possibile importare un file CSV

Solo il workspace owner può importare dati e la tabella di destinazione deve essere scrivibile. Assicurati che:

• Il file usi il formato .csv.
• Il file non sia superiore a 10 MB.
• Le sue colonne e i suoi dati siano compatibili con lo schema della tabella di destinazione.
• Tu abbia confermato o scartato eventuali modifiche di riga in sospeso.

Se l'importazione continua a non riuscire, contatta Support e includi il link del progetto o della Chat, l'ambiente, la tabella di destinazione, il ruolo nello spazio di lavoro, il nome e la dimensione del file, l'azione tentata e il testo esatto dell'errore.

FAQ

Il mio database di produzione non si sincronizza. Cosa devo fare?

Se Development funziona normalmente ma il sito live (Production) mostra tabelle, colonne mancanti o errori di migrazione:

Importante: non ricostruire né sovrascrivere il database di produzione autonomamente.

Informazioni necessarie:

• Link della Chat e URL live
• Messaggio di errore SQL completo
• Nomi delle tabelle/colonne mancanti
• Ultima modifica dello schema del database
• Ultima versione live funzionante
• Se i dati di produzione devono essere preservati
• Se vuoi sincronizzare completamente i dati di Development o solo colmare le strutture mancanti

Contatta il supporto con questi dettagli così potremo confrontare le versioni Development/Production, lo stato della migrazione e le differenze di schema prima di apportare modifiche.

Perché i miei dati di sviluppo sono diversi dai dati di produzione?

Se hai pubblicato più volte ma Production mostra ancora dati vecchi mentre gli aggiornamenti del codice funzionano correttamente:

Prima di contattare il supporto, conferma:

1. I dati di produzione attuali devono essere preservati?

2. Vuoi sovrascrivere completamente con i dati attuali di Development oppure solo colmare i record mancanti?

3. Hai già un backup?

4. Qual è la finestra di manutenzione accettabile?

Non sovrascriveremo né ricostruiremo i dati di produzione finché l'obiettivo di gestione dei dati non sarà confermato. Fornisci gli URL di Development/Production e ID record di esempio o conteggi che mostrino la differenza.