מסד נתונים

מדריך זה מכסה את מסד הנתונים המובנה בתוך Atoms Cloud. אם הפרויקט שלך משתמש ב-Supabase, ראה Supabase Connect במקום זאת.

פתיחת מסד נתונים

לפני פתיחת מסד נתונים, חבר את הפרויקט שלך אל Atoms Cloud. אם הוא עדיין לא מחובר, בצע את שלבי החיבור שב Atoms Cloud.

1. פתח את הפרויקט שלך במכשיר שולחני.
2. באותו סרגל כלים של סביבת העבודה שבו נמצא App Viewer בחר Atoms Cloud.
3. בחר מסד נתונים בסרגל הצד של Atoms Cloud.
4. תחת Databases, בחר איזה מסד נתונים ברצונך לבדוק. כרטיסי מסד הנתונים של Development ו- Production מופיעים כאשר הם זמינים עבור הפרויקט.

כל כרטיס מסד נתונים מציג כמה אחסון נמצא בשימוש ואת הסכום הכולל הזמין. השתמש ב- Development בזמן בנייה ובדיקה של האפליקציה שלך. שינויים שבוצעו ב- Production עשויים להשפיע על נתוני האפליקציה הפעילה, לכן תמיד בדוק באיזו סביבה אתה נמצא לפני ביצוע שינויים.

בחר את מסד הנתונים Development או Production.

עיון וסינון של נתוני טבלה

1. בחר את Development או Production כרטיס מסד הנתונים, בהתאם לסביבה שבה ברצונך לעבוד.
2. השתמש ב- Search tables כדי למצוא טבלה, או בחר אחת ישירות מהרשימה. כל כרטיס טבלה מציג את מספר השורות שלה והאם היא לקריאה בלבד.
3. השתמש ב- Search rows כדי לחפש בתוך הטבלה הנוכחית, או בחר Filter כדי לצמצם את התוצאות באמצעות שדה אחד או יותר.
4. השתמש בפקדי החצים של הדפים מתחת לטבלה כדי להציג שורות נוספות.
5. כדי לבדוק את מבנה הטבלה, פתח את תפריט ••• ובחר Schema.

תצוגת Schema מציגה את השם של כל שדה, סוג הנתונים, מצב המפתח, הדרישות, האילוצים וערך ברירת המחדל. בחר Copy כדי להעתיק את הסכימה המוצגת.

הוספה, עריכה או מחיקה של שורות

כאשר מצאת את מסד הנתונים שבו ברצונך לבצע שינויים, אפשר להשתמש בפעולות האלה כדי לעשות זאת:

פעולה	איך לבצע אותה
הוספת שורה	פתח... ובחר Add Row. הזן ערכים שתואמים לשדות הזמינים, ולאחר מכן שלח את השורה.
עריכת שורה	לחץ פעמיים על תא והזן את הערך החדש. בחרCommit Changes כדי לשמור את כל העריכות הממתינות, או Discard כדי להסיר אותן.
מחיקת שורות	בחר שורה אחת או יותר, בחרDelete, ואז אשר. לא ניתן לבטל מחיקת שורות.

הוספת שורה או אישור מחיקה מחילים את השינוי מיד על מסד הנתונים שנבחר. רק עריכות תאים בתוך השורה מחייבות אותך לבחור Commit Changes או Discard. אם יש לך עריכות ממתינות, אשר או בטל אותן לפני הוספת שורה, ייבוא או ייצוא של קובץ CSV, שינוי החיפוש או המסננים, או מעבר לעמוד אחר.

אם הפרויקט נמצא בסביבת עבודה, רק Editors ו- בעל סביבת העבודה יכולים לערוך שורות בטבלאות שניתנות לכתיבה. אם Atoms לא מצליח לזהות מפתח ראשי עבור טבלה, לא תוכל לערוך או למחוק את השורות שלה כי Atoms לא יכול לזהות באופן אמין רשומות בודדות.

בדוק עריכת שורה ממתינה, ואז אשר או בטל את השינוי.

יצירת טבלאות או שינוי הסכימה

פתח את סביבת מסד הנתונים שברצונך לעדכן, ולאחר מכן פעל לפי ההוראות עבור השינוי שברצונך לבצע:

פעולה	איך לבצע אותה
יצירת טבלה	ברשימת הטבלאות, לחץ על..., ובחר Create table. הזן שם טבלה חוקי ואת השדות הראשוניים, ולאחר מכן שלח את הבקשה. המתן עד שה-Agent יסיים, פתח מחדש את מסד נתונים, ואמת את הטבלה.
שינוי הסכימה	לחץ על הטבלה שבה ברצונך לבצע שינויים, ולאחר מכן לחץ על..., ובחר Schema. השתמש ב- Add Field כדי ליצור שדה, או בחר שדה מתאים כדי לערוך אותו. אפשר לשנות את השם שלו, הסוג, ערך ברירת המחדל, מצב החובה או הייחודיות. אפשר גם לסמן שדות שאינם מפתח למחיקה. בחר Submit Changes כדי לשלוח את הבקשה ל-Agent, או Discard כדי לנקות את השינויים הממתינים שלך.

רק ה- בעל סביבת העבודה יכול ליצור טבלאות או לשנות את הסכימה של טבלה.

שליחת בקשת סכימה לא אומרת שהמיגרציה הושלמה. המתן עד שה-Agent יסיים, אמת את התוצאה ב- מסד נתונים, ובדוק את האפליקציה שלך לאחר מכן. לא ניתן לשנות בדרך זו שדות מפתח ראשי וטבלאות לקריאה בלבד.

הזן את פרטי השדה החדש ב-Add Field.

בדוק את שינויי הסכימה הממתינים לפני בחירה ב-Submit Changes.

ייבוא או ייצוא של נתוני CSV

בחר את הטבלה שברצונך לעבוד איתה, ולאחר מכן פעל לפי ההוראות עבור הפעולה הרלוונטית:

פעולה	איך לבצע אותה
Import CSV	לחץ על... ובחר Import CSV. בחר קובץ .csv שאינו גדול מ-10 MB, ולאחר מכן בדוק את שם הקובץ, מספר השורות המשוער, הטבלה שנבחרה והסביבה לפני האישור. עמודות ה-CSV חייבות להתאים לסכימת הטבלה. שורות מיובאות מתווספות מיד ולא ניתן לבטל אותן אוטומטית, לכן שקול לייצא תחילה את הנתונים הקיימים.
Export CSV	לחץ על... ובחר Export CSV. אם חיפוש או מסנן פעילים, רק השורות התואמות ייוצאו. אחרת, כל הנתונים מהטבלה הנוכחית ייוצאו.

רק ה- בעל סביבת העבודה יכול לייבא או לייצא קובצי CSV. עבור טבלאות לקריאה בלבד, Export CSV היא האפשרות היחידה הזמינה.

הרשאות וטבלאות מוגנות

פעולה	מי יכול לבצע אותה	דרישות נוספות
הוספה, עריכה או מחיקה של שורות	עורך או בעל סביבת עבודה	הטבלה חייבת להיות ניתנת לכתיבה. עריכה ומחיקה של שורות דורשות גם מידע על מפתח ראשי.
יצירת טבלאות או שינוי סכימות	בעל סביבת העבודה	לא ניתן לשנות שדות מפתח ראשי וטבלאות לקריאה בלבד.
ייבוא או ייצוא של קובצי CSV	בעל סביבת העבודה	לא ניתן לייבא קובצי CSV לטבלאות לקריאה בלבד.

טבלאות מערכת או משתמש מוגנות עשויות להציג תג Read-only אפשר לצפות בנתונים שלהן ולבדוק את הסכימה שלהן כאשר היא זמינה, אך לא ניתן לשנות את השורות או המבנה שלהן מעמוד זה.

פתרון בעיות נפוצות במסד הנתונים

“No databases found” או “No tables found”

ודא ש- Atoms Cloud מחובר לפרויקט. אם הוא כבר מחובר, אשר שהאפליקציה שלך כוללת תכונה ששומרת נתונים מתמשכים. אם צריך, בקש מה-Agent להוסיף את התכונה המבוססת על מסד נתונים. לאחר שה-Agent יסיים, פתח מחדש את מסד נתונים או בחר Refresh.

פעולת מסד נתונים חסרה או לא זמינה

בדוק אם לטבלה יש תג Read-only ולאחר מכן עיין בהרשאות שלמעלה כדי לאשר שתפקידך בסביבת העבודה מאפשר את הפעולה. עריכה ומחיקה של שורות דורשות גם מידע על מפתח ראשי.

עריכות שורות ממתינות יכולות למנוע פעולות אחרות. בחר Commit Changes או Discard לפני הוספת שורה, ייבוא או ייצוא של קובץ CSV, שינוי החיפוש או המסננים, או מעבר לעמוד אחר.

אם הפעולה עדיין לא זמינה לאחר הבדיקות האלה, פנה אל Support וכלול את קישור הפרויקט או ה-Chat, הסביבה, הטבלה, תפקידך בסביבת העבודה, הפעולה שנוסתה וטקסט השגיאה המדויק.

לא ניתן לייבא קובץ CSV

רק ה- בעל סביבת העבודה יכול לייבא נתונים, וטבלת היעד חייבת להיות ניתנת לכתיבה. ודא ש:

• הקובץ משתמש בפורמט .csv .
• גודל הקובץ אינו עולה על 10 MB.
• העמודות והנתונים שלו תואמים לסכימת טבלת היעד.
• אישרת או ביטלת כל עריכת שורה ממתינה.

אם הייבוא עדיין נכשל, פנה אל Support וכלול את קישור הפרויקט או ה-Chat, הסביבה, טבלת היעד, תפקידך בסביבת העבודה, שם הקובץ וגודלו, הפעולה שנוסתה וטקסט השגיאה המדויק.

שאלות נפוצות

My production database is not syncing. What should I do?

אם Development עובד כרגיל אבל האתר הפעיל (Production) מציג טבלאות, עמודות או שגיאות מיגרציה חסרות:

חשוב: אל תבנה מחדש ואל תדרוס את מסד הנתונים של הייצור בעצמך.

מידע נדרש:

• קישור Chat ו-URL פעיל
• הודעת שגיאת SQL מלאה
• שמות טבלאות/עמודות חסרים
• השינוי האחרון בסכימת מסד הנתונים
• הגרסה הפעילה האחרונה שעבדה
• האם יש לשמור על נתוני הייצור
• האם ברצונך לסנכרן באופן מלא את נתוני Development או רק להשלים מבנים חסרים

פנה לתמיכה עם הפרטים האלה כדי שנוכל להשוות בין גרסאות Development/Production, מצב המיגרציה והבדלי הסכימה לפני ביצוע שינויים.

Why is my development data different from production data?

אם פרסמת כמה פעמים אבל Production עדיין מציג נתונים ישנים בעוד שעדכוני הקוד עובדים מצוין:

לפני פנייה לתמיכה, אשר:

1. האם יש לשמור על נתוני הייצור הנוכחיים?

2. האם ברצונך לדרוס לחלוטין עם נתוני Development הנוכחיים, או רק להשלים רשומות חסרות?

3. האם כבר יש לך גיבוי?

4. מהו חלון התחזוקה המקובל עליך?

לא נדרוס או נבנה מחדש נתוני ייצור עד שמטרת הטיפול בנתונים תאושר. ספק את כתובות ה-URL של Development/Production ודוגמאות של מזהי רשומות או ספירות שמציגות את ההבדל.

Can I move a database from one Atoms project to another without losing data?

Atoms אינו תומך כרגע במיגרציית מסד נתונים אוטומטית וללא אובדן בין פרויקטים. יצירת פרויקט חדש או פיצול של פרויקט קיים לא יעתיקו אוטומטית חשבונות משתמשים או רשומות מסד נתונים קיימות לפרויקט החדש.

לפני שממשיכים:

• אל תאפס, תחליף, תעביר או תמחק את מסד הנתונים הקיים או את משאבי הפרויקט.
• השאר את הפרויקט המקורי ללא שינוי כמקור לנתונים הקיימים.
• פנה אל Atoms Support וספק את פרויקט המקור, פרויקט היעד, ספק מסד הנתונים והנתונים שיש לשמר.

במקרים מסוימים, ייתכן שהצוות יוכל לסייע בהעתקה ידנית חד-פעמית ממסד הנתונים של המקור למסד הנתונים של היעד. זה אינו סנכרון רציף: כל נתון חדש שייכתב למקור לאחר תחילת ההעתקה לא יופיע אוטומטית ביעד.

כדי למזער הבדלי נתונים, השהה כתיבות למסד הנתונים של המקור במהלך חלון המיגרציה ואמת את הנתונים שהועתקו בפרויקט היעד לפני המעבר אליו. כרגע לא ניתן להבטיח מיגרציה ללא אובדן באופן מלא.