다음을 통해 공유


샌드박스

적용 대상: ✅Azure Data Explorer

Kusto는 안전하고 격리된 환경에서 실행해야 하는 특정 흐름에 대해 샌드박스를 실행할 수 있습니다. 이러한 흐름의 예로 Python 플러그 인 또는 R 플러그사용하여 실행되는 사용자 정의 스크립트가 있습니다.

샌드박스는 원격 호출에 대한 추가 대기 시간 없이 로컬로 실행됩니다(즉, 처리는 데이터 가까이에서 수행됨).

필수 구성 요소 및 제한 사항

  • 샌드박스는 Hyper-V 기술을 사용하여 구현되고 제한 사항이 없는 중첩된 가상화를 지원하는 VM 크기에서 실행되어야 합니다.
  • 샌드박스를 실행하기 위한 이미지는 모든 클러스터 노드에 배포되며 전용 SSD 공간을 실행해야 합니다.
    • 예상 크기는 10~20GB 사이입니다.
    • 이는 클러스터의 데이터 용량에 영향을 미치며 클러스터 비용에 영향을 줄 수 있습니다.

런타임

  • 샌드박스 쿼리 연산자는 해당 실행에 하나 이상의 샌드박스를 사용할 수 있습니다.
    • 샌드박스는 단일 쿼리에만 사용되며 해당 쿼리가 완료되면 삭제됩니다.
    • 예를 들어 서비스 업그레이드의 일부로 노드를 다시 시작하면 노드에서 실행 중인 모든 샌드박스가 삭제됩니다.
  • 각 노드는 들어오는 요청을 실행할 준비가 된 미리 정의된 수의 샌드박스를 유지 관리합니다.
    • 샌드박스가 사용되면 새 샌드박스를 자동으로 교체할 수 있게 됩니다.
  • 쿼리 연산자를 제공하는 데 미리 할당된 샌드박스가 없는 경우 새 샌드박스를 사용할 수 있을 때까지 제한됩니다. 자세한 내용은 오류를 참조 하세요. 새 샌드박스 할당은 데이터 노드에서 SKU 및 사용 가능한 리소스에 따라 샌드박스당 최대 10-15초가 걸릴 수 있습니다.

샌드박스 매개 변수

일부 매개 변수는 각 종류의 샌드박스에 대해 클러스터 수준 샌드박스 정책을 사용하여 제어할 수 있습니다.

  • 노드당 샌드박스 수: 노드당 샌드박스 수가 제한됩니다.
    • 사용 가능한 샌드박스가 없을 때 만들어진 요청은 제한됩니다.
  • 시작 시 초기화: (기본값)으로 false 설정하면 노드에서 샌드박스가 지연 초기화되며, 쿼리를 실행하기 위해 처음으로 샌드박스가 필요합니다. 그렇지 않은 경우 샌드 true박스는 서비스 시작의 일부로 초기화됩니다.
    • 즉, 노드에서 샌드박스를 사용하는 플러그 인의 첫 번째 실행에는 짧은 준비 기간이 포함됩니다.
  • CPU: 샌드박스에서 호스트 프로세서를 사용할 수 있는 CPU의 최대 속도는 제한됩니다(기본값은 50%).
    • 제한에 도달하면 샌드박스의 CPU 사용이 제한되지만 실행은 계속됩니다.
  • 메모리: 샌드박스가 호스트의 RAM을 사용할 수 있는 최대 RAM 양은 제한됩니다.
    • Hyper-V 기술의 기본 메모리는 1GB이고 레거시 샌드박스의 경우 20GB입니다.
    • 제한에 도달하면 샌드박스가 종료되고 쿼리 실행 오류가 발생합니다.

샌드박스 제한 사항

  • 네트워크: 샌드박스는 VM(가상 머신) 또는 외부의 리소스와 상호 작용할 수 없습니다.
    • 샌드박스는 다른 샌드박스와 상호 작용할 수 없습니다.

참고 항목

샌드박스와 함께 사용되는 리소스는 요청의 일부로 처리되는 데이터의 크기뿐만 아니라 샌드박스에서 실행되는 논리 및 샌드박스에서 사용되는 라이브러리의 구현에 따라 달라집니다. 예를 들어 플러그 인 및 r 플러그 인의 경우 python 후자는 사용자가 제공한 스크립트와 런타임에 사용하는 Python 또는 R 라이브러리를 의미합니다.

Errors

오류 코드 상태 메시지 잠재적인 이유
E_SB_QUERY_THROTTLED_ERROR TooManyRequests (429) 샌드박스 쿼리가 제한으로 인해 중단되었습니다. 일부 백오프가 성공한 후 다시 시도 대상 노드에는 사용 가능한 샌드박스가 없습니다. 몇 초 안에 새 샌드박스를 사용할 수 있어야 합니다.
E_SB_QUERY_THROTTLED_ERROR TooManyRequests (429) '{kind}' 종류의 샌드박스가 아직 초기화되지 않았습니다. 샌드박스 정책이 최근에 변경되었습니다. 새 정책을 준수하는 새 샌드박스는 몇 초 후에 사용할 수 있게 됩니다.
InternalServiceError(520) 샌드박스 초기화 실패로 인해 샌드박스 쿼리가 중단되었습니다. 예기치 않은 인프라 오류입니다.

중첩된 가상화를 지원하는 VM 크기

다음 표에서는 Hyper-V 샌드박스 기술을 지원하는 모든 최신 VM 크기를 나열합니다.

이름 범주
Standard_L8s_v3 스토리지 최적화
Standard_L16s_v3 스토리지 최적화
Standard_L8as_v3 스토리지 최적화
Standard_L16as_v3 스토리지 최적화
Standard_E8as_v5 스토리지 최적화
Standard_E16as_v5 스토리지 최적화
Standard_E8s_v4 스토리지 최적화
Standard_E16s_v4 스토리지 최적화
Standard_E8s_v5 스토리지 최적화
Standard_E16s_v5 스토리지 최적화
Standard_E2ads_v5 컴퓨팅 최적화
Standard_E4ads_v5 컴퓨팅 최적화
Standard_E8ads_v5 컴퓨팅 최적화
Standard_E16ads_v5 컴퓨팅 최적화
Standard_E2d_v4 컴퓨팅 최적화
Standard_E4d_v4 컴퓨팅 최적화
Standard_E8d_v4 컴퓨팅 최적화
Standard_E16d_v4 컴퓨팅 최적화
Standard_E2d_v5 컴퓨팅 최적화
Standard_E4d_v5 컴퓨팅 최적화
Standard_E8d_v5 컴퓨팅 최적화
Standard_E16d_v5 컴퓨팅 최적화
Standard_D32d_v4 컴퓨팅 최적화