자동화된 품질 게이트
레시피가 게시되기 전 확인해야 할 5가지 사항
완전한 레시피 계약
감사에는 질문, 이벤트 스키마, SQL, 샘플 결과, 시각화, 설명, 엣지 케이스, 대시보드 지침, 알림 지침 및 관련 읽기가 필요합니다.
읽기 전용 문 정책
쿼리는 SELECT 또는 WITH로 시작해야 합니다. 감사에서는 DDL을 거부하고 CREATE, INSERT, UPDATE, DELETE, DROP, ALTER 및 MERGE와 같은 키워드를 작성합니다.
DataFusion 실행을 입력했습니다.
Each schema becomes an empty Apache Arrow record batch. The query is planned and executed with Apache DataFusion 45.2.0, catching invalid columns, types, functions, and syntax.
재현 가능한 브라우저 고정 장치
30 cross-category recipes also execute their complete synthetic input with DuckDB 1.3.2 and compare every expected result value within displayed precision.
렌더링된 페이지 무결성
사이트 감사에서는 모든 레시피를 렌더링하고 해당 상태, 표준 URL, 제목, 설명, H1, 구조화된 데이터 및 내부 링크를 확인합니다.
실행 확인이 증명하는 것
감사에서는 레시피 페이지에 표시된 필드 이름과 화살표 유형을 사용하여 문서화된 모든 테이블을 구성합니다. 새로운 DataFusion 세션에 빈 배치를 등록하고 게시된 정확한 SQL을 실행하며 엔진이 계획이나 실행을 거부하면 실패합니다. 이는 철자가 틀린 필드, 호환되지 않는 작업, 지원되지 않는 함수, 모호한 열, 형식이 잘못된 간격 및 많은 반환 유형 실수를 프로덕션 데이터 없이 포착합니다.
고정된 버전은 의도적인 것입니다. SQL 엔진이 발전하므로 유사한 방언이 허용한다고 해서 쿼리가 호환 가능하다고 표시되지는 않습니다. 애플리케이션이 DataFusion를 업그레이드하면 문서화된 버전이 변경되기 전에 전체 컬렉션이 다시 실행됩니다.
복사해도 안전하다고 가정해도 안전하지 않습니다
쿼리는 활성 계정, 복구된 지불, 영구 웹훅 실패 또는 허용 가능한 대기 시간에 대한 정의를 알 수 없습니다. 각 레시피에는 이러한 선택 사항의 이름이 지정되므로 검토자는 대시보드나 알림이 승인되기 전에 이를 변경할 수 있습니다.
사람의 검토
아직 판단이 필요한 것
빈 유형의 테이블은 쿼리가 계획되고 실행된다는 것을 증명합니다. 이는 비즈니스 정의가 정확하다는 것을 증명하지 않습니다.
표시된 행과 차트는 결정론적 합성 예입니다. 이는 벤치마크나 고객 결과가 아닌 출력 형태와 의도된 해석을 보여줍니다.
임계값, 최소 볼륨, 시간 창, 신원 규칙, 통화 및 터미널 상태는 이를 소유하는 이벤트 계약에 맞게 조정되어야 합니다.
SQL이 유효한 경우에도 늦은 이벤트, 중복된 공급자 제공, 불완전한 최신 버킷 및 스키마 변경으로 인해 실제 결과가 변경될 수 있습니다.
공공 픽스처 계약
모든 레시피는 입력된 스키마, 예시 입력 행, 정확한 SQL, 결정론적 예상 출력, 엔진 버전 및 리뷰 노트가 포함된 JSON 번들을 게시합니다. CSV는 동일한 표시된 결과를 노출하는 반면, 정적 SVG는 예시 차트를 색인화하고 재사용할 수 있게 만듭니다. 압축 입력은 필드 이름과 JSON 유형을 보여줍니다. 의도적으로 집계 결과에 대한 완전한 생성자로 표시되지 않습니다.
는 30 재현 가능한 레시피는 더욱 발전합니다. 완전한 합성 행은 브라우저 SQL 놀이터 예상 값과 비교하여 확인됩니다. 다른 컴팩트 입력은 스키마 데모로 남아 있어 작은 교육 장치가 통계 검증 세트로 오인되는 것을 방지합니다.
는 연결된 SQL 연구실 별도의 버전이 있는 합성 SaaS 데이터 세트를 사용하므로 학습자는 강의 데이터를 프로덕션 벤치마크와 혼동하지 않고 조인 및 다단계 비즈니스 정의를 연습할 수 있습니다.
기본 엔진 참조
Apache는 권위 있는 SQL 구문, 함수, 유형 및 업그레이드 문서를 게시합니다. 라이브 참조는 Telemetry의 고정된 테스트 대상보다 최신 릴리스를 설명할 수 있으므로 레시피 페이지의 호환성 주장은 계속해서 정확한 감사 버전의 이름을 지정합니다.
자신의 이벤트 계약에서 레시피를 검증하세요.
필드 이름과 유형을 일치시키고, 성공 및 실패 경로를 포함하는 작은 합성 픽스처를 보내고, 중간 CTE를 검사하고, 총계를 알려진 입력과 비교하고, 저장된 쿼리 옆에 최종 비즈니스 정의를 문서화합니다.