GraphQL 用 Fabric API でストアドプロシージャを使用する

Microsoft Fabric API for GraphQL を使用すると、厳密に型指定されたスキーマと豊富なクエリ言語を使用して、Fabric SQL データベースやその他の Fabric データソース (Data Warehouse や Lakehouse など) からデータのクエリと変更を簡単に行えるようになり、開発者はカスタムサーバーコードを記述せずに直感的な API を作成できます。ストアドプロシージャを使用すると、入力の検証やデータ変換など、複雑なビジネスロジックをカプセル化して再利用できます。

GraphQL でストアドプロシージャを使用するユーザー

GraphQL のストアドプロシージャは、次の場合に重要です。

Fabric SQL データベースでデータ検証、変換、および処理ワークフローを実装するデータエンジニア
最新の GraphQL API を使用して Fabric ウェアハウスから複雑なビジネスロジックを公開するバックエンド開発者
Fabric プラットフォーム内のビジネスルールをカプセル化する、セキュリティで保護されたパフォーマンスの高い API を設計するアプリケーションアーキテクト
GraphQL インターフェイスを使用して既存の Fabric SQL データベースストアドプロシージャを最新化するデータベース開発者

データの検証、複雑な計算、または複数ステップのデータベース操作にサーバー側ロジックが必要な場合は、ストアドプロシージャを使用します。

この記事では、Fabric で GraphQL の変更を通じてストアドプロシージャを公開する方法について説明します。この例では、サーバー側の検証、データ変換、ID 生成を含む製品登録ワークフローを実装します。すべてストアドプロシージャにカプセル化され、GraphQL を介してアクセスできます。

[前提条件]

開始する前に、サンプルデータを含む Fabric SQL データベースが必要です。

Fabric ワークスペースで、新しい項目>SQL データベース (プレビュー) を選択します
データベースに名前を付ける
[ サンプルデータ ] を選択して、必要なテーブルとデータを作成します

これにより、AdventureWorks サンプルデータベースが作成されます。このデータベースには、この例で使用されている SalesLT.Product テーブルが含まれます。

シナリオ: 新しい製品を登録する

この例では、組み込みのビジネスロジックを使用して新しい製品を登録するためのストアドプロシージャを作成します。

検証: ListPrice が StandardCost より大きいことを確認します
データ変換: 製品名を大文字にし、製品番号を正規化します
ID 生成: 利用可能な次の ProductID を自動的に割り当てます

このロジックをストアドプロシージャにカプセル化することで、どのクライアントアプリケーションがデータを送信するかに関係なく、一貫したデータ品質を確保できます。

手順 1: ストアドプロシージャを作成する

製品登録ロジックを実装する T-SQL ストアドプロシージャを作成します。

SQL データベースで、[新しいクエリ] を選択します

次のステートメントを実行します。

CREATE PROCEDURE SalesLT.RegisterProduct
  @Name nvarchar(50),
  @ProductNumber nvarchar(25),
  @StandardCost money,
  @ListPrice money,
  @SellStartDate datetime
AS
BEGIN
  SET NOCOUNT ON;
  SET IDENTITY\_INSERT SalesLT.Product ON;

  -- Validate pricing logic
  IF @ListPrice <= @StandardCost
    THROW 50005, 'ListPrice must be greater than StandardCost.', 1;

-- Transform product name: capitalize first letter only
  DECLARE @CleanName nvarchar(50);
  SET @CleanName = UPPER(LEFT(LTRIM(RTRIM(@Name)), 1)) + LOWER(SUBSTRING(LTRIM(RTRIM(@Name)), 2, 49));

  -- Trim and uppercase product number
  DECLARE @CleanProductNumber nvarchar(25);
  SET @CleanProductNumber = UPPER(LTRIM(RTRIM(@ProductNumber)));

  -- Generate ProductID by incrementing the latest existing ID
  DECLARE @ProductID int;
  SELECT @ProductID = ISNULL(MAX(ProductID), 0) + 1 FROM SalesLT.Product;

  INSERT INTO SalesLT.Product (
    ProductID,
    Name,
    ProductNumber,
    StandardCost,
    ListPrice,
    SellStartDate
  )
  OUTPUT 
    inserted.ProductID,
    inserted.Name,
    inserted.ProductNumber,
    inserted.StandardCost,
    inserted.ListPrice,
    inserted.SellStartDate
  VALUES (
    @ProductID,
    @CleanName,
    @CleanProductNumber,
    @StandardCost,
    @ListPrice,
    @SellStartDate
  );
END;

[ 実行 ] を選択してストアドプロシージャを作成する

作成後、SalesLT スキーマのストアドプロシージャの下に RegisterProduct が表示されます。手順をテストして、正しく動作することを確認します。

DECLARE @RC int
DECLARE @Name nvarchar(50)
DECLARE @ProductNumber nvarchar(25)
DECLARE @StandardCost money
DECLARE @ListPrice money
DECLARE @SellStartDate datetime

-- TODO: Set parameter values here.
Set @Name = 'test product'       
Set @ProductNumber = 'tst-0012'
Set @StandardCost = '10.00'
Set @ListPrice = '9.00'
Set @SellStartDate = '2025-05-01T00:00:00Z'

EXECUTE @RC = \[SalesLT\].\[RegisterProduct\] 
   @Name
  ,@ProductNumber
  ,@StandardCost
  ,@ListPrice
  ,@SellStartDate
GO

手順 2: GraphQL API を作成する

次に、テーブルとストアドプロシージャの両方を公開する GraphQL API を作成します。

SQL データベースリボンで、GraphQL 用の新しい API を選択します
API に名前を付ける
[ データの取得 ] 画面で、 SalesLT スキーマを選択します
公開するテーブルと RegisterProduct ストアドプロシージャを選択します
[読み込み] を選択

GraphQL API、スキーマ、およびすべてのリゾルバーは、SQL テーブルとストアドプロシージャに基づいて数秒で自動的に生成されます。

手順 3: GraphQL からプロシージャを呼び出す

Fabric では、ストアドプロシージャの GraphQL の変更が自動的に生成されます。変異名はパターン execute{ProcedureName}に従うので、RegisterProduct プロシージャは executeRegisterProductになります。

変異をテストするには:

クエリエディターで API を開く

次の変更を実行します。

mutation {
   executeRegisterProduct (
    Name: " graphQL swag ",
    ProductNumber: "gql-swag-001",
    StandardCost: 10.0,
    ListPrice: 15.0,
    SellStartDate: "2025-05-01T00:00:00Z"
  ) {
ProductID
    Name
    ProductNumber
    StandardCost
    ListPrice
    SellStartDate
   }
}

ストアドプロシージャのビジネスロジックが入力を自動的に処理する方法に注目してください。

"graphQL swag" が "Graphql swag" になります (大文字)
"gql-swag-001" が "GQL-SWAG-001" になります (大文字)
ProductID は、次の順次番号として自動的に生成されます

ベストプラクティス

GraphQL 用 API でストアドプロシージャを使用する場合:

戻り値の結果セット: OUTPUT または戻り値の結果セットを使用するストアドプロシージャに対して、Fabric によって自動的に変更が生成されます。返される列は、GraphQL の変更の戻り値の型になります。
ビジネスロジックをカプセル化する: 検証、変換、複雑な計算は、クライアントコードではなくストアドプロシージャに保持します。これにより、すべてのアプリケーションの一貫性が確保されます。
エラーを適切に処理する: THROW ステートメントを使用して、GraphQL API を介して表示できる意味のあるエラーメッセージを返します。
ID 生成を検討する: ID 列を使用していない場合は、カスタム ID 生成ロジック (MAX のインクリメントなど) のみを使用します。運用シナリオでは、通常、ID 列の方が信頼性が高くなります。
ドキュメントパラメーター: GraphQL フィールド名に適切に変換する明確なパラメーター名を使用します。

GraphQL 用 Fabric API を介してストアドプロシージャを公開することで、SQL の手続き型ロジックの機能と GraphQL の柔軟なクエリインターフェイスを組み合わせて、堅牢で保守可能なデータアクセスパターンを作成できます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-01-21

次の方法で共有

GraphQL 用 Fabric API でストアド プロシージャを使用する

GraphQL でストアド プロシージャを使用するユーザー

[前提条件]

シナリオ: 新しい製品を登録する

手順 1: ストアド プロシージャを作成する