RequestOptions interface

Azure Cosmos DB 서버에 발급된 요청된 에 대해 지정할 수 있는 옵션입니다.=

Extends

속성

accessCondition

요청과 관련된 조건입니다.

consistencyLevel

클라이언트에 필요한 일관성 수준입니다.

disableAutomaticIdGeneration

자동 ID 생성을 사용하지 않도록 설정(ID가 정의에 없으면 가 생성되지 않음)

disableRUPerMinuteUsage

DisableRUPerMinuteUsage는 일반 프로비전된 RU/초가 소진된 경우 요청을 제공하기 위해 RU(요청 단위)/분 용량을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다.

enableScriptLogging

JavaScript 저장 프로시저에서 로깅을 사용하거나 사용하지 않도록 설정합니다.

indexingDirective

인덱싱 지시문(인덱스, 인덱스 안 함 등)을 지정합니다.

offerThroughput

단위당 요청 측정에서 컨테이너에 대해 프로비전된 제품 처리량입니다.

offerType

문서 컨테이너를 만들 때 제품 유형입니다.

이 옵션은 문서 컨테이너를 만들 때만 유효합니다.

populateQuotaInfo

문서 컨테이너 읽기 요청에 대한 문서 컨테이너 할당량 관련 통계 가져오기를 사용하거나 사용하지 않도록 설정합니다.

postTriggerInclude

작업 후 호출할 post 트리거가 무엇인지 나타냅니다.

preTriggerInclude

작업 전에 호출할 사전 트리거가 무엇인지 나타냅니다.

resourceTokenExpirySeconds

권한과 연결된 리소스 토큰의 만료 시간(초)입니다(권한에 대한 요청에만 적용됨).

urlConnection

(고급 사용 사례) 연결할 URL입니다.

상속된 속성

abortSignal

abortSignal - 이 메서드 호출에서 만든 모든 기본 네트워크 요청에 전달합니다. https://developer.mozilla.org/en-US/docs/Web/API/AbortController을 참조하십시오.

예제

읽기 요청 취소

const controller = new AbortController()
const {result: item} = await items.query('SELECT * from c', { abortSignal: controller.signal});
controller.abort()
initialHeaders

(고급 사용 사례) Cosmos에 요청을 보낼 때 시작할 초기 헤더

maxIntegratedCacheStalenessInMs

Azure CosmosDB 서비스의 요청과 연결된 부실 값을 설정합니다. 가 <xref:com.azure.cosmos.ConsistencyLevel><xref:com.azure.cosmos.ConsistencyLevel%23EVENTUAL> 또는 <xref:com.azure.cosmos.ConsistencyLevel%23SESSION>인 요청의 경우 통합 캐시의 응답은 이 maxIntegratedCacheStaleness로 표시된 값보다 더 이상 부실하지 않습니다. 일관성 수준이 설정되지 않은 경우 이 속성은 무시됩니다.

기본값은 null입니다.

캐시 부실은 밀리초 단위로 지원됩니다. 밀리초보다 작은 항목은 무시됩니다.

priorityLevel

각 요청에 대한 우선 순위 수준(낮음/높음)입니다. 우선 순위가 낮은 요청은 항상 우선 순위가 높은 요청 전에 제한됩니다.

기본값은 null입니다. 기본적으로 모든 요청은 높은 우선 순위입니다.

sessionToken

문서 컨테이너 읽기 요청에 대한 문서 컨테이너 할당량 관련 통계 가져오기를 사용하거나 사용하지 않도록 설정합니다.

속성 세부 정보

accessCondition

요청과 관련된 조건입니다.

accessCondition?: { condition: string, type: string }

속성 값

{ condition: string, type: string }

consistencyLevel

클라이언트에 필요한 일관성 수준입니다.

consistencyLevel?: string

속성 값

string

disableAutomaticIdGeneration

자동 ID 생성을 사용하지 않도록 설정(ID가 정의에 없으면 가 생성되지 않음)

disableAutomaticIdGeneration?: boolean

속성 값

boolean

disableRUPerMinuteUsage

DisableRUPerMinuteUsage는 일반 프로비전된 RU/초가 소진된 경우 요청을 제공하기 위해 RU(요청 단위)/분 용량을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다.

disableRUPerMinuteUsage?: boolean

속성 값

boolean

enableScriptLogging

JavaScript 저장 프로시저에서 로깅을 사용하거나 사용하지 않도록 설정합니다.

enableScriptLogging?: boolean

속성 값

boolean

indexingDirective

인덱싱 지시문(인덱스, 인덱스 안 함 등)을 지정합니다.

indexingDirective?: string

속성 값

string

offerThroughput

단위당 요청 측정에서 컨테이너에 대해 프로비전된 제품 처리량입니다.

offerThroughput?: number

속성 값

number

offerType

문서 컨테이너를 만들 때 제품 유형입니다.

이 옵션은 문서 컨테이너를 만들 때만 유효합니다.

offerType?: string

속성 값

string

populateQuotaInfo

문서 컨테이너 읽기 요청에 대한 문서 컨테이너 할당량 관련 통계 가져오기를 사용하거나 사용하지 않도록 설정합니다.

populateQuotaInfo?: boolean

속성 값

boolean

postTriggerInclude

작업 후 호출할 post 트리거가 무엇인지 나타냅니다.

postTriggerInclude?: string | string[]

속성 값

string | string[]

preTriggerInclude

작업 전에 호출할 사전 트리거가 무엇인지 나타냅니다.

preTriggerInclude?: string | string[]

속성 값

string | string[]

resourceTokenExpirySeconds

권한과 연결된 리소스 토큰의 만료 시간(초)입니다(권한에 대한 요청에만 적용됨).

resourceTokenExpirySeconds?: number

속성 값

number

urlConnection

(고급 사용 사례) 연결할 URL입니다.

urlConnection?: string

속성 값

string

상속된 속성 세부 정보

abortSignal

abortSignal - 이 메서드 호출에서 만든 모든 기본 네트워크 요청에 전달합니다. https://developer.mozilla.org/en-US/docs/Web/API/AbortController을 참조하십시오.

예제

읽기 요청 취소

const controller = new AbortController()
const {result: item} = await items.query('SELECT * from c', { abortSignal: controller.signal});
controller.abort()
abortSignal?: AbortSignal

속성 값

AbortSignal

SharedOptions.abortSignal에서 상속

initialHeaders

(고급 사용 사례) Cosmos에 요청을 보낼 때 시작할 초기 헤더

initialHeaders?: CosmosHeaders

속성 값

SharedOptions.initialHeaders에서 상속됨

maxIntegratedCacheStalenessInMs

Azure CosmosDB 서비스의 요청과 연결된 부실 값을 설정합니다. 가 <xref:com.azure.cosmos.ConsistencyLevel><xref:com.azure.cosmos.ConsistencyLevel%23EVENTUAL> 또는 <xref:com.azure.cosmos.ConsistencyLevel%23SESSION>인 요청의 경우 통합 캐시의 응답은 이 maxIntegratedCacheStaleness로 표시된 값보다 더 이상 부실하지 않습니다. 일관성 수준이 설정되지 않은 경우 이 속성은 무시됩니다.

기본값은 null입니다.

캐시 부실은 밀리초 단위로 지원됩니다. 밀리초보다 작은 항목은 무시됩니다.

maxIntegratedCacheStalenessInMs?: number

속성 값

number

SharedOptions.maxIntegratedCacheStalenessInMs에서 상속

priorityLevel

각 요청에 대한 우선 순위 수준(낮음/높음)입니다. 우선 순위가 낮은 요청은 항상 우선 순위가 높은 요청 전에 제한됩니다.

기본값은 null입니다. 기본적으로 모든 요청은 높은 우선 순위입니다.

priorityLevel?: PriorityLevel

속성 값

SharedOptions.priorityLevel에서 상속됨

sessionToken

문서 컨테이너 읽기 요청에 대한 문서 컨테이너 할당량 관련 통계 가져오기를 사용하거나 사용하지 않도록 설정합니다.

sessionToken?: string

속성 값

string

SharedOptions.sessionToken에서 상속됨