ワークロード通信

この記事では、Microsoft Fabric のフロントエンドとバックエンド間の通信のしくみについて説明します。 管理者とユーザーの主な考慮事項についても対象です。

フロントエンドからバックエンドへの通信

フロントエンドとバックエンド間の認証は、セキュリティで保護された認証済みのチャネルを介して行われます。 他のサービスとの通信用にバックエンドでトークンを使用できるようにするために、Fabric フロントエンドを使用してバックエンドに通信を渡すことができます。

エラー処理

コントロール プレーン API (GetItemJobInstanceStateAsync を除く CRUD 操作とジョブ) を操作するときにワークロード バックエンドで発生したエラーをワークロード フロントエンドに伝達するために、ワークロード バックエンドがエラー状態コードを返す必要があります。 応答本文の内容は、ワークロード バックエンドのコントラクトの一部であるクラス ErrorResponse のシリアル化された JSON ファイルである必要があります。

次に例を示します。

    var errorResponse = new ErrorResponse
    {
        ErrorCode = ErrorCode,
        Message = ErrorMessage,
        MessageParameters = _messageParameters.Any() ? _messageParameters : null,
        Source = ErrorSource,
        IsPermanent = IsPermanent,
        MoreDetails = Details,
    };
    
    
    return new ContentResult
    {
        StatusCode = (int)HttpStatusCode,
        Content = JsonSerializer.Serialize(errorResponse),
        ContentType = MediaTypeNames.Application.Json,
    };