ייבוא של קובץ CSV

בדף הזה מוסבר איך לייבא נתונים מקובץ CSV שמאוחסן בקטגוריה של Cloud Storage לאשכול AlloyDB ל-PostgreSQL.

אפשר לבטל את הייבוא של נתונים לאשכולות AlloyDB. איך מבטלים פעולת ייבוא

לפני שמתחילים

לפני שמתחילים בפעולת ייבוא:

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

תפקידים והרשאות שנדרשים לייבוא לאשכולות של AlloyDB

כדי לייבא נתונים מ-Cloud Storage אל AlloyDB, למשתמש שמבצע את הייבוא צריך להיות אחד מהתפקידים הבאים:

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

  • תפקיד IAM‏ storage.objectViewer
  • תפקיד בהתאמה אישית, כולל ההרשאות הבאות:
    • storage.objects.get

במאמר ניהול זהויות והרשאות גישה מוסבר איך משתמשים בתפקידים ב-IAM.

ייבוא נתונים מקובץ CSV לאשכולות AlloyDB

  • מסד הנתונים והטבלה שאליהם מייבאים את הנתונים צריכים להיות קיימים באשכול AlloyDB. למידע נוסף על יצירת מסד נתונים, אפשר לקרוא את המאמר יצירת מסד נתונים.
  • בקובצי CSV צריכה להיות שורה אחת לכל שורת נתונים, והשדות צריכים להיות מופרדים בפסיקים.
  • קובצי CSV לא יכולים להכיל שורת כותרת. אם בקובץ ה-CSV יש שורת כותרת, צריך להסיר אותה לפני הייבוא.

כדי לייבא נתונים לאשכול AlloyDB באמצעות קובץ CSV, פועלים לפי השלבים הבאים:

המסוף

  1. עוברים לדף Clusters.

    מעבר אל Clusters

  2. לוחצים על שם האשכול כדי לפתוח את הדף סקירה כללית של האשכול.

  3. לוחצים על Import.

  4. בקטע פורמט קובץ, בוחרים באפשרות CSV.

  5. בקטע בחירת קובץ מקור, בוחרים אם להעלות קבצים מהמחשב או לבחור קובץ ממיקום באחסון בענן.

    1. כדי להעלות קובץ מהמחשב:

      1. בוחרים באפשרות העלאת קבצים מהמחשב.
      2. לוחצים על עיון לצד בחירת קובץ מקומי כדי לבחור קובץ CSV מהמחשב.
      3. לוחצים על Browse (עיון) לצד Select Cloud Storage location (בחירת מיקום ב-Cloud Storage) כדי לבחור מיקום ב-Cloud Storage לאחסון הקובץ המקומי שהועלה.
      4. לוחצים על העלאה כדי להעלות את הקובץ.

    2. כדי לבחור קובץ CSV שקיים בקטגוריה של Cloud Storage:

      1. בוחרים באפשרות בחירת קובץ מ-Google Cloud Storage.
      2. לוחצים על Browse לצד bucket-name/file-name כדי לבחור קובץ CSV מקטגוריה של Cloud Storage.

  6. בתפריט הנפתח מסד נתונים, בוחרים את מסד הנתונים שאליו רוצים לייבא את הנתונים.

  7. בתפריט הנפתח טבלה, בוחרים את הטבלה במסד הנתונים.

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

  9. כדי להתחיל את פעולת הייבוא, לוחצים על ייבוא.

gcloud

  1. יצירת קטגוריה של Cloud Storage
  2. מעלים את קובץ ה-CSV לקטגוריה. לקבלת עזרה בהעלאת קבצים לקטגוריות, ראו העלאת אובייקטים.

  3. משתמשים בפקודה gcloud storage buckets add-iam-policy-binding כדי להעניק את storage.objectViewer תפקיד ה-IAM לחשבון השירות של AlloyDB עבור הדלי.

     service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

    במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.

  4. מייבאים את הקובץ:

    gcloud alloydb clusters import CLUSTER_NAME --region=REGION --gcs-uri=gs://BUCKET_NAME/FILE_NAME --database=DATABASE_NAME --user=USER --csv --table=TABLE_NAME

    מחליפים את הפרטים הבאים:

    • ‫CLUSTER_NAME: שם האשכול.
    • ‫REGION: האזור שבו נפרס אשכול AlloyDB.
    • ‫BUCKET_NAME: שם הקטגוריה ב-Cloud Storage.
    • ‫FILE_NAME: השם של קובץ ה-CSV.
    • ‫DATABASE_NAME: השם של מסד נתונים בתוך האשכול.
    • ‫USER: המשתמש של פעולת הייבוא.
    • ‫TABLE_NAME: הטבלה בתוך מסד הנתונים.

    מידע נוסף על השימוש בפקודה import זמין בדף העזרה של הפקודה alloydb import.

  5. אם אין צורך לשמור את הרשאות ה-IAM שהגדרתם קודם, מסירים אותן באמצעות gcloud storage buckets remove-iam-policy-binding.

REST v1

  1. יצירת קטגוריה של Cloud Storage
  2. מעלים את קובץ ה-CSV לקטגוריה. לקבלת עזרה בהעלאת קבצים לקטגוריות, ראו העלאת אובייקטים.

  3. נותנים לחשבון השירות הרשאות לקטגוריה של Cloud Storage עבור פעולת הייבוא. משתמשים בפורמט של חשבון השירות כדי לזהות את חשבון השירות של הפרויקט שאליו מייבאים. הפורמט של חשבון השירות הוא:

    service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

  4. משתמשים בפקודה gcloud storage buckets add-iam-policy-binding כדי להעניק את storage.objectViewer תפקיד ה-IAM לחשבון השירות של אשכול AlloyDB עבור הקטגוריה. במאמר שימוש בהרשאות IAM מוסבר איך מגדירים הרשאות IAM.

  5. מייבאים את הקובץ.

    משתמשים ב-method הבא ב-HTTP ובכתובת ה-URL:

    POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:import