GraphQL 스키마 뷰 및 스키마 탐색기용 Fabric API
GraphQL SDL(스키마 정의 언어)을 기반으로 하는 GraphQL 스키마는 API에 노출되는 데이터의 형식을 정의합니다. 백 엔드 구현 세부 정보를 숨기면서 소비자에게 유연성을 제공하는 추상화 계층입니다. 스키마는 필드를 포함하는 개체 형식의 컬렉션을 기반으로 합니다.
스키마 뷰
데이터 개발 화면의 왼쪽 아래 모서리에서 스키마를 선택하여 스키마 보기에 액세스할 수 있습니다. 이 보기는 생성된 형식, 필드 및 작업이 있는 GraphQL SDL의 텍스트 기반 버전을 보여 줍니다.
다음 이미지는 이 스키마에서 사용할 수 있는 광범위한 개체 목록을 포함하여 스키마 보기의 예입니다.
참고 항목
스키마 뷰는 읽기 전용입니다. 스키마 탐색기에서만 개체를 수정할 수 있습니다.
스키마 탐색기
스키마 탐색기는 왼쪽 창에 있으며 쿼리 보기에서 편집기를 사용할 때도 사용할 수 있습니다. 탐색기를 사용하면 사용자가 API에 정의된 쿼리 및 변형뿐만 아니라 사용 가능한 형식 및 필드를 빠르게 시각화할 수 있습니다.
데이터 원본에 연결할 때 선택한 개체에서 사용할 수 있는 모든 GraphQL 형식이 스키마 탐색기 목록에 표시됩니다. 형식은 파생된 데이터 원본의 이름 아래에 표시됩니다. 다음 이미지에는 AdventureWorks SQL 분석 엔드포인트의 SalesOrderDetail 테이블에서 파생된 SalesOrderDetail 형식이 표시됩니다.
형식 외에도 GraphQL용 Fabric API는 노출하도록 선택한 새 개체에 대한 쿼리 및 변형을 자동으로 생성합니다.
AdventureWorks 예제에서 쿼리 목록을 확장하면 데이터 원본에 대해 자동으로 생성된 쿼리가 표시됩니다.
API에서 자동으로 생성된 돌연변이를 보려면 스키마 탐색기 트리에서 변형 노드를 확장합니다.
스키마 탐색기를 사용하여 개체 수정
스키마 탐색기를 사용하여 API에서 개체를 만든 후 개체를 수정할 수 있습니다. 다음 예제에서는 AdventureWorks 데이터베이스에서 파생된 SalesOrderDetail 형식 옆에 있는 줄임표를 선택합니다.
유형에 사용할 수 있는 옵션은 다음과 같습니다.
- 스키마 업데이트 - 데이터 원본의 새 개체로 스키마를 업데이트할 수 있습니다.
- 이름 바꾸기 - 개체의 이름을 변경합니다. 참고: 이 변경 내용은 API 스키마에만 영향을 미치며 파생된 원래 데이터 원본 개체에는 영향을 주지 않습니다.
- 스키마에서 제거 - 더 이상 참조할 수 없도록 GraphQL 스키마에서 개체를 효과적으로 삭제합니다.
- 관계 관리 - 관계 관리 환경으로 이동합니다. 자세한 내용은 GraphQL용 Fabric API의 관계 관리를 참조 하세요.
- 속성 - 개체에 대한 추가 정보를 표시합니다.
쿼리 및 변형 사용 및 사용 안 함
쿼리 및 변형에 대한 사용/사용 안 함 기능은 관리자와 개발자에게 API 액세스 및 사용에 대한 세부적인 제어를 제공합니다. 이를 통해 GraphQL 스키마 내에서 특정 쿼리 및 변형을 선택적으로 활성화하거나 비활성화할 수 있습니다. 이렇게 하면 코드를 수정하거나 변경 내용을 배포하지 않고도 API 기능을 동적으로 관리할 수 있습니다.
스키마 탐색기의 쿼리 및 변형에는 두 가지 추가 옵션이 있습니다.
- 사용 안 함 - 모든 요청이 쿼리 또는 변형을 실행하지 못하도록 합니다. 실행을 시도하면 오류가 반환됩니다. 쿼리 또는 변형을 사용하지 않도록 설정하면 스키마 다시 로드가 발생하고 스키마 탐색기에서 쿼리 또는 변형이 회색으로 표시됩니다.
- 사용 - 이전에 사용하지 않도록 설정된 쿼리 또는 변형을 다시 사용하도록 설정합니다. 항목의 실행은 사용 옵션을 선택한 후 발생하는 스키마 다시 로드 작업 시 즉시 사용할 수 있습니다.
저장 프로시저에서 자동으로 생성된 쿼리 또는 변형은 삭제할 수 있습니다. 삭제되면 데이터 가져오기 또는 스키마 업데이트 옵션을 사용하여 다시 추가할 수 있습니다.