GraphQL 編輯器的 Fabric API

適用於 GraphQL 的 Fabric API 提供圖形化的瀏覽器內 GraphQL 開發環境，這是一個互動式平台，讓您撰寫、測試及查看 GraphQL 查詢和變動的即時結果。

若要移至編輯器，請從 Fabric 中的工作區開啟 GraphQL 專案的 API，然後選取入口網站畫面左下角的 [查詢]。

直接在 「查詢」 標籤上輸入並執行GraphQL查詢。Intellisense 功能可透過鍵盤快速鍵使用：CTRL + 空格鍵 （Windows） 或 Command + 空格鍵 （macOS）。 選取 [執行] 以執行查詢，並從資料來源擷取資料。

產生程式碼

在測試和原型化所需的 GraphQL 操作後，API 編輯器會根據編輯器中執行的查詢或突變產生樣板 Python 或 Node.js 程式碼。 您可以在本機運行生成的代碼以進行測試，並在應用程序開發過程中重複使用其中的一部分。

重要

產生的程式代碼會使用互動式瀏覽器認證，而且應該僅用於測試目的。 在生產過程中，請一律在 Microsoft Entra 中註冊應用程式，並使用適當的 client_id 和權限範圍。 您可以在連線應用程式找到具有範例程式碼的端對端範例。

若要開始使用，請執行查詢，選取 產生程式碼 按鈕，然後相應地選擇語言：

然後，您可以複製產生的程式代碼，並將其儲存為本機資料夾中的檔案。 根據所選語言，請按照以下簡單步驟在本地進行測試：

Python

1. 執行命令 python -m venv .venv來建立虛擬環境。

2. venv通過運行.venv\Scripts\activate或source .venv/bin/activate激活 。

3. 執行 來 pip install azure.identity安裝所需的相依性。

4. 使用 python <filename.py>執行程式碼。

Node.JS

1. 在您儲存的檔案所在的相同資料夾中，使用 package.json 下列內容建立檔案：

   {
     "type": "module",
     "dependencies": {}
   }
   

2. 在您選擇的套件管理員中執行 npm install --save @azure/identity 或類似的命令，以安裝最新版本的身分識別程式庫。

3. 使用 node <filename>.js執行程式碼。

查詢和變動的開發

檢閱此簡短的 GraphQL 結構描述。 它定義了一種單一 Post 類型，其中包含讀取單一貼文或列出所有貼文的查詢，以及用於建立、更新或刪除貼文的突變，支援所有 CRUDL（建立、讀取、更新、刪除、列出）用例。

{
  type Post {
    id: ID!
    published: Boolean
  }

  type Query {
    getPost(id: ID!): Post
    getAllPosts: [Post]
  }

  type Mutation {
    createPost(title: String!, content: String!, author: String!): Post
    updatePost(id: ID!, title: String, content: String, author: String, published: Boolean): Post
    deletePost(id: ID!): Boolean
  }
}

使用結構描述中定義的任何查詢，讀取透過GraphQL公開的資料。 getPost查詢看起來像這個範例。

query MyQuery {
  getPost(id: "1234") {
    title
    content
    author
  }
}

回應：

{
  "data": {
    "getPost": {
      "title": "First Post",
      "content": "This is my first post.",
      "author": "Jane Doe"
    }
  }
}

使用突變（例如 createPost 寫入數據）並創建具有所需參數的帖子。

mutation MyMutation {
  createPost(title: "Second post", content: "This is my second post", author: "Jane Doe", published: false) {
    id
    title
    content
    author
  }
}

回應：

{
  "data": {
    "createPost": {
      "id": "5678",
      "title": "Second Post",
      "content": "This is my second post.",
      "author": "Jane Doe"
    }
  }
}

查詢變數

使用 [查詢] 索引標籤右側的 [查詢變數] 窗格，將參數作為變數傳遞至查詢或變動。 變數的工作方式類似於其他程式語言中的變數。 每個變數都宣告了一個名稱，用於存取其中儲存的值。 使用上一個突變範例，您可以稍微修改它以使用查詢變數。

mutation MyMutation ($title: String!, $content: String!, $author: String!){
  createPost(title: $title, content: $content, author: $author) {
    id
    title
    content
    author
  }
}

使用下列範例在窗格中定義變數。

{
  "id": "5678",
  "title": "Second Post",
  "content": "This is my second post.",
  "author": "Jane Doe"
}

變數使突變程式碼更乾淨、更易於閱讀、測試和修改。

相關內容

• 更多查詢和變動範例
• 適用於 GraphQL 結構描述檢視和結構描述總管的 Fabric API