סייר בבונה API של נתונים עבור מסד נתונים של Azure SQL

7 דקות

בעולם מונחה הנתונים של כיום, היכולת לגשת לנתונים ולטפל בהם ביעילות היא חיונית לעסקים ולמפתחים כאחד. בונה API של נתונים (DAB) מציע פתרון רב-עוצמה ליצירת נקודות קצה מודרניות של REST ו- GraphQL עבור מסד הנתונים של Azure SQL, תוך החלפת ממשקי API מותאמים אישית שמבצעים פעולות CRUD (יצירה, קריאה, עדכון, מחיקה) במסד נתונים.

Azure Data API Builder הוא כלי קוד פתוח, המיועד למפתחים, כדי לפשט את תהליך חשיפת אובייקטי מסד הנתונים כנקודות קצה. הוא תומך במסדי נתונים רבים, כולל, אך לא מוגבל ל- Azure SQL, SQL Server, PostgreSQL ו- Azure Cosmos DB. באמצעות DAB, באפשרותך ליצור ממשקי API מאובטחים, מדרגיים ובעלי ביצועים גבוהים ללא עלות נוספת, מבלי לכתוב קוד כלשהו.

גלה תכונות עיקריות

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

תאימות חוצת פלטפורמות: DAB היא חוצת פלטפורמות והיא יכולה לפעול בכל ענן או סביבה מקומית. הוא תומך במקורות נתונים עורפיים מרובים, כולל מסדי נתונים יחסיים ומסדי נתונים של NoSQL.
אבטחה ואימות: DAB משתלב עם שיטות אימות שונות, כולל OAuth2, EasyAuth ומזהה Microsoft Entra. הוא תומך גם בפקדי הרשאה מבוססי תפקיד ואבטחה פרטנית. משמעות הדבר היא שבאפשרותך לחשוף את הנתונים שלך תוך שמירה על השליטה על האנשים שיכולים לגשת אליהם ועל הפעולות שהם יכולים לעשות איתם.
נוחות שימוש: עם קובץ תצורה יחיד, באפשרותך להגדיר את נקודות הקצה של ה- API, דבר ההפיכת תהליך ההגדרה לתהליך פשוט ויעיל.
שילוב עם שירותי Azure: DAB משתלב בצורה חלקה עם Azure Static Web Apps, Azure Container Apps ושירותים אחרים של Azure, ושיפור הפונקציונליות והמדרגיות שלה.

כדי לראות רשימה של התכונות הזמינות עבור בונה ה- API של הנתונים, ראה זמינות תכונות עבור בונה ה- API של הנתונים.

שימוש בבונה API של נתונים

כדי להתחיל בעבודה עם Azure Data API Builder, ודא שיש לך מנוי Azure וכלים הדרושים מותקנים, כגון .NET 8 העדכני ביותר ו- Azure Developer CLI.

צור פרוייקט חדש: השתמש ב- CLI של Azure Developer כדי ליצור ולפרוס את השירותים הנדרשים. לדוגמה, השתמש ב- CLI של Azure Developer כדי לפרוס Azure Static Web App שמארח את בונה ה- API של הנתונים. נווט אל הספריה שבה ברצונך ליצור את הפרוייקט והפעל את הפקודה הבאה כדי ליצור פרוייקט חדש של Azure Static Web App.
```
azd init --template staticwebapp
azd up
```
קבע את תצורת החיבור למסד הנתונים: קשר את מסד הנתונים של Azure SQL ליישום האינטרנט הסטטי שנפרס באמצעות תכונת חיבורי מסד הנתונים. נווט אל Azure Static Web App שיצרת, ותחת הגדרות, קשר מסד נתונים קיים תחת דף החיבור של מסד הנתונים.
הגדרת נקודות קצה של API: צור קובץ תצורה כדי להגדיר את נקודות הקצה של REST או GraphQL. קובץ זה מציין את אובייקטי מסד הנתונים לחשיפה ואת הפעולות המותרות. לדוגמה, באפשרותך להפעיל את הפקודה הבאה כדי להוסיף את ישויות מסד הנתונים לקובץ התצורה.
```
dab add "Address" --source "dbo.Address" --permissions "anonymous:*" --config "swa-db-connections/staticwebapp.database.config.json"
```

סקירת קובץ תצורה

להלן דוגמה פשוטה של קובץ תצורה לחשיפה של טבלה במסד הנתונים של Azure SQL.

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "Server=tcp:your_server.database.windows.net,1433;Initial Catalog=your_database;Persist Security Info=False;User ID=your_user;Password=your_password;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
  },
  "entities": {
    "products": {
      "source": "Address",
      "rest": true,
      "graphql": true,
      "permissions": [
        {
          "role": "anonymous",
          "actions": ["read"]
        }
      ]
    }
  }
}

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

משוב

האם עמוד זה היה מועיל?