コレクション内のデータの公開

1. コレクションのロールを設定する

App Services はすべての受信 GraphQL リクエストに対してコレクション ルールを強制するため、アプリケーションに必要な権限を持つ少なくとも 1 つのコレクション ロールを定義する必要があります。

すべての GraphQL リクエストには、リクエストを送信したログイン App Services ユーザーを識別する認証トークンが含まれています。 App Services は、GraphQL 操作に含まれるすべてのドキュメントに対してロールを評価し、ユーザーが表示権限を持つフィールドとドキュメントのみを返します。 App Services がフィールドを省略した場合、返されるドキュメントのフィールドには null値が含まれます。

2. コレクション内のドキュメントのスキーマを定義する

GraphQL では、すべてのデータが明確に定義された型に準拠している必要があるため、コレクション内のドキュメントにはスキーマを定義および強制 する必要があります。 App Services は、コレクション スキーマに基づいてコレクション内のドキュメントのGraphQL 型とリゾルバを自動的に生成し、スキーマが変更されるたびに新しい型を再生成します。

3. 他のコレクションとの関係を定義する

コレクション内の各ドキュメントを外部コレクション内の 1 つ以上のドキュメントに接続する関係を定義できます。 関係を定義する方法については、「 関係の定義 」を参照してください。

関係により、GraphQL の読み取りおよび書込み操作において関連するドキュメントをスムーズに参照およびクエリできます。 たとえば、人物をクエリし、同じpeopleコレクションから各人の完全なドキュメントを含めることができます。

query {
  person(query: { name: "Molly Weasley" }) {
    _id
    name
    age
    picture
    children {
      _id
      name
      age
      picture
    }
  }
}

4. データ型に名前を付ける

Atlas App Services は、コレクション内のドキュメントが準拠するデータ型に基づいて、生成する GraphQL 型に名前を付けます。 GraphQL 型の名前を構成するには、スキーマのtitleフィールドを、スキーマが定義するデータ型の名前に設定します。

titleフィールドを設定できる状況は 3 つあります。

• スキーマのルートレベルでtitleを設定することで、コレクション内の各ドキュメントのタイプ名を定義できます。 タイトルを指定しない場合、App Services は代わりにコレクションの名前を使用します。

• 埋め込みオブジェクト スキーマでtitleを設定することで、埋め込みオブジェクトのタイプ名を定義できます。

• フィールド スキーマでtitleを設定することで、定義された関係を持つフィールドのタイプ名を定義できます。 App Services は、GraphQL の 関係 を解決するときに、定義されたフィールド名ではなくtitleを使用します。

{
  "title": "movie",
  "properties": {
    "_id": { "bsonType": "objectId" },
    "title": { "bsonType": "string" },
    "year": { "bsonType": "int" },
    "director": { "bsonType": "int" }
  }
}

{
  "title": "Mouse",
  "bsonType": "object",
  "properties": {
    "_id": { "bsonType": "objectId" },
    "name": { "bsonType": "string" },
    "age": { "bsonType": "int" }
  }
}

query Mice {
  mouse(query: { _id: "5ebe6819197003ddb1f74475" }) {
    name
    age
  }
  mice {
    name
    age
  }
}