Database
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 usando file CSV.
Questa guida copre il database integrato in Atoms Cloud. Se il tuo progetto usa Supabase, consulta invece Connessione Supabase.
Aprire 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.
- Apri il tuo progetto su un dispositivo desktop.
- Nella stessa barra degli strumenti dello spazio di lavoro in cui si trova Visualizzatore App, seleziona Atoms Cloud.
- Seleziona Database nella barra laterale di Atoms Cloud.
- 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 è in uso 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.
Sfogliare e filtrare i dati della tabella
- Seleziona la scheda del database Development o Production, a seconda dell'ambiente in cui vuoi lavorare.
- 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.
- Usa Search rows per cercare nella tabella corrente oppure seleziona Filter per restringere i risultati usando uno o più campi.
- Usa i controlli con le frecce di pagina sotto la tabella per visualizzare righe aggiuntive.
- 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.
Aggiungere, modificare o eliminare righe
Quando hai trovato il database su cui vuoi apportare modifiche, puoi usare queste azioni per farlo:
| Operation | How to do it |
|---|---|
| Aggiungere una riga | Apri ... e seleziona Add Row. Inserisci valori che corrispondano ai campi disponibili, quindi invia la riga. |
| Modificare 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. |
| Eliminare 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.
Controlla una modifica di riga in sospeso, quindi conferma o scarta la modifica.
Creare tabelle o modificare lo schema
Apri l'ambiente del database che vuoi aggiornare, quindi segui le istruzioni per la modifica che vuoi apportare:
| Operation | How to do it |
|---|---|
| Creare 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. |
| Modificare lo schema | Fai clic sulla tabella su 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 chiave primaria e le tabelle di sola lettura non possono essere modificati in questo modo.
Inserisci i dettagli del nuovo campo in Add Field.
Controlla le modifiche allo schema in sospeso prima di selezionare Submit Changes.
Importare o esportare dati CSV
Seleziona la tabella con cui vuoi lavorare, quindi segui le istruzioni per l'operazione pertinente:
| Operation | How to do it |
|---|---|
| Import CSV | Fai clic su ... e seleziona Import CSV. Scegli un file .csv non più grande di 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. |
| Export 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
| Action | Who can perform it | Additional requirements |
|---|---|---|
| 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 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.
Risolvere 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 memorizza 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.
Un'azione del database è mancante 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.
Impossibile 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 più grande di 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 da solo.
Informazioni necessarie:
- Link della Chat e URL live
- Messaggio di errore SQL completo
- Nomi delle tabelle/colonne mancanti
- Ultima modifica allo 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 attuali di produzione 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 o conteggi di record di esempio che mostrino la differenza.