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.
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.
- 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 mentre sviluppi e testi la 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
- Seleziona la scheda del database Development o Production, in base all'ambiente in cui vuoi lavorare.
- Usa Search tables per trovare una tabella, oppure selezionane una direttamente dall'elenco. Ogni scheda 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.
Aggiungi, modifica o elimina righe
Quando hai trovato il database su cui vuoi apportare modifiche, puoi usare queste azioni per farlo:
| Operazione | Come fare |
|---|---|
| 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. SelezionaCommit Changes per salvare tutte le modifiche in sospeso, oppure Discard per rimuoverle. |
| Elimina righe | Seleziona una o più righe, selezionaDelete, 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 alle 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, o 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.
Crea tabelle o modifica lo schema
Apri l'ambiente del database che vuoi aggiornare, quindi segui le istruzioni per la modifica che vuoi apportare:
| Operazione | Come fare |
|---|---|
| Crea una tabella | Nell'elenco delle tabelle, fai clic su... e seleziona Create table. Inserisci un nome 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 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 testa la tua app in seguito. 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 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 fare |
|---|---|
| Importa 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. |
| 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 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.
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, o 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.
Un file CSV non può essere importato
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 riempire le strutture mancanti
Contatta il supporto con questi dettagli così possiamo 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 correnti di Development, oppure solo riempire i record mancanti?
3. Hai già un backup?
4. Qual è la tua 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.
Posso spostare un database da un progetto Atoms a un altro senza perdere dati?
Atoms al momento non supporta la migrazione automatica e senza perdita di dati del database tra progetti. La creazione di un nuovo progetto o la suddivisione di un progetto esistente non copierà automaticamente gli account utente o i record del database esistenti nel nuovo progetto.
Prima di procedere:
- Non reimpostare, sostituire, migrare o eliminare il database esistente o le risorse del progetto.
- Mantieni invariato il progetto originale come fonte dei dati esistenti.
- Contatta Atoms Support e fornisci il progetto di origine, il progetto di destinazione, il provider del database e i dati che devono essere preservati.
In alcuni casi, il team potrebbe essere in grado di aiutare con una copia manuale una tantum dal database di origine al database di destinazione. Non si tratta di una sincronizzazione continua: qualsiasi nuovo dato scritto nell'origine dopo l'inizio della copia non apparirà automaticamente nella destinazione.
Per ridurre al minimo le differenze nei dati, sospendi le scritture nel database di origine durante la finestra di migrazione e verifica i dati copiati nel progetto di destinazione prima di passare a esso. Al momento non è possibile garantire una migrazione completamente senza perdita di dati.