Udostępnij za pośrednictwem


RequestOptions interface

Opcje, które można określić dla żądanego wystawionego dla serwerów usługi Azure Cosmos DB.=

Extends

Właściwości

accessCondition

Warunki skojarzone z żądaniem.

consistencyLevel

Poziom spójności wymagany przez klienta.

disableAutomaticIdGeneration

Wyłącz automatyczne generowanie identyfikatorów (spowoduje niepowodzenie tworzenia, jeśli identyfikator nie znajduje się w definicji)

disableRUPerMinuteUsage

Funkcja DisableRUPerMinuteUsage służy do włączania/wyłączania pojemności jednostek żądań (RU)/minuty w celu obsłużenia żądania w przypadku wyczerpania aprowizowanej jednostki RU/sekundy.

enableScriptLogging

Włącza lub wyłącza rejestrowanie w procedurach składowanych w języku JavaScript.

indexingDirective

Określa dyrektywy indeksowania (indeks, nie indeksuj itp.).

offerThroughput

Przepływność oferty aprowizowana dla kontenera w pomiarze żądań na jednostkę.

offerType

Typ oferty podczas tworzenia kontenerów dokumentów.

Ta opcja jest prawidłowa tylko podczas tworzenia kontenera dokumentów.

populateQuotaInfo

Włącza/wyłącza pobieranie statystyk związanych z limitem przydziału kontenera dokumentów dla żądań odczytu kontenera dokumentów.

postTriggerInclude

Wskazuje, jaki wyzwalacz post ma być wywoływany po operacji.

preTriggerInclude

Wskazuje, jaki jest wyzwalacz wstępny do wywołania przed operacją.

resourceTokenExpirySeconds

Czas wygaśnięcia (w sekundach) tokenu zasobu skojarzonego z uprawnieniem (dotyczy tylko żądań dotyczących uprawnień).

urlConnection

(Zaawansowany przypadek użycia) Adres URL do nawiązania połączenia.

Właściwości dziedziczone

abortSignal

abortSignal przekazać do wszystkich podstawowych żądań sieciowych utworzonych przez to wywołanie metody. Zobacz https://developer.mozilla.org/en-US/docs/Web/API/AbortController

Przykład

Anulowanie żądania odczytu

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

(Zaawansowany przypadek użycia) Początkowe nagłówki do rozpoczęcia od wysyłania żądań do usługi Cosmos

maxIntegratedCacheStalenessInMs

Ustawia wartość nieaktualności skojarzona z żądaniem w usłudze Azure CosmosDB. W przypadku żądań, w których wartość <xref:com.azure.cosmos.ConsistencyLevel> to <xref:com.azure.cosmos.ConsistencyLevel%23EVENTUAL> lub <xref:com.azure.cosmos.ConsistencyLevel%23SESSION>, odpowiedzi ze zintegrowanej pamięci podręcznej mają gwarancję, że nie są nieaktualne niż wartość wskazana przez tę wartość maxIntegratedCacheStaleness. Jeśli poziom spójności nie jest ustawiony, ta właściwość jest ignorowana.

Wartość domyślna to null

Nieaktualność pamięci podręcznej jest obsługiwana w milisekundach szczegółowości. Wszystkie elementy mniejsze niż milisekundy zostaną zignorowane.

priorityLevel

Poziom priorytetu (niski/wysoki) dla każdego żądania. Żądania o niskim priorytcie są zawsze ograniczane przed żądaniami o wysokim priorytcie.

Wartość domyślna to null. Domyślnie wszystkie żądania mają wysoki priorytet

sessionToken

Włącza/wyłącza pobieranie statystyk związanych z limitem przydziału kontenera dokumentów dla żądań odczytu kontenera dokumentów.

Szczegóły właściwości

accessCondition

Warunki skojarzone z żądaniem.

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

Wartość właściwości

{ condition: string, type: string }

consistencyLevel

Poziom spójności wymagany przez klienta.

consistencyLevel?: string

Wartość właściwości

string

disableAutomaticIdGeneration

Wyłącz automatyczne generowanie identyfikatorów (spowoduje niepowodzenie tworzenia, jeśli identyfikator nie znajduje się w definicji)

disableAutomaticIdGeneration?: boolean

Wartość właściwości

boolean

disableRUPerMinuteUsage

Funkcja DisableRUPerMinuteUsage służy do włączania/wyłączania pojemności jednostek żądań (RU)/minuty w celu obsłużenia żądania w przypadku wyczerpania aprowizowanej jednostki RU/sekundy.

disableRUPerMinuteUsage?: boolean

Wartość właściwości

boolean

enableScriptLogging

Włącza lub wyłącza rejestrowanie w procedurach składowanych w języku JavaScript.

enableScriptLogging?: boolean

Wartość właściwości

boolean

indexingDirective

Określa dyrektywy indeksowania (indeks, nie indeksuj itp.).

indexingDirective?: string

Wartość właściwości

string

offerThroughput

Przepływność oferty aprowizowana dla kontenera w pomiarze żądań na jednostkę.

offerThroughput?: number

Wartość właściwości

number

offerType

Typ oferty podczas tworzenia kontenerów dokumentów.

Ta opcja jest prawidłowa tylko podczas tworzenia kontenera dokumentów.

offerType?: string

Wartość właściwości

string

populateQuotaInfo

Włącza/wyłącza pobieranie statystyk związanych z limitem przydziału kontenera dokumentów dla żądań odczytu kontenera dokumentów.

populateQuotaInfo?: boolean

Wartość właściwości

boolean

postTriggerInclude

Wskazuje, jaki wyzwalacz post ma być wywoływany po operacji.

postTriggerInclude?: string | string[]

Wartość właściwości

string | string[]

preTriggerInclude

Wskazuje, jaki jest wyzwalacz wstępny do wywołania przed operacją.

preTriggerInclude?: string | string[]

Wartość właściwości

string | string[]

resourceTokenExpirySeconds

Czas wygaśnięcia (w sekundach) tokenu zasobu skojarzonego z uprawnieniem (dotyczy tylko żądań dotyczących uprawnień).

resourceTokenExpirySeconds?: number

Wartość właściwości

number

urlConnection

(Zaawansowany przypadek użycia) Adres URL do nawiązania połączenia.

urlConnection?: string

Wartość właściwości

string

Szczegóły właściwości dziedziczonej

abortSignal

abortSignal przekazać do wszystkich podstawowych żądań sieciowych utworzonych przez to wywołanie metody. Zobacz https://developer.mozilla.org/en-US/docs/Web/API/AbortController

Przykład

Anulowanie żądania odczytu

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

Wartość właściwości

AbortSignal

Dziedziczone zsharedOptions.abortSignal

initialHeaders

(Zaawansowany przypadek użycia) Początkowe nagłówki do rozpoczęcia od wysyłania żądań do usługi Cosmos

initialHeaders?: CosmosHeaders

Wartość właściwości

Dziedziczone zsharedOptions.initialHeaders

maxIntegratedCacheStalenessInMs

Ustawia wartość nieaktualności skojarzona z żądaniem w usłudze Azure CosmosDB. W przypadku żądań, w których wartość <xref:com.azure.cosmos.ConsistencyLevel> to <xref:com.azure.cosmos.ConsistencyLevel%23EVENTUAL> lub <xref:com.azure.cosmos.ConsistencyLevel%23SESSION>, odpowiedzi ze zintegrowanej pamięci podręcznej mają gwarancję, że nie są nieaktualne niż wartość wskazana przez tę wartość maxIntegratedCacheStaleness. Jeśli poziom spójności nie jest ustawiony, ta właściwość jest ignorowana.

Wartość domyślna to null

Nieaktualność pamięci podręcznej jest obsługiwana w milisekundach szczegółowości. Wszystkie elementy mniejsze niż milisekundy zostaną zignorowane.

maxIntegratedCacheStalenessInMs?: number

Wartość właściwości

number

Dziedziczone zsharedOptions.maxIntegratedCacheStalenessInMs

priorityLevel

Poziom priorytetu (niski/wysoki) dla każdego żądania. Żądania o niskim priorytcie są zawsze ograniczane przed żądaniami o wysokim priorytcie.

Wartość domyślna to null. Domyślnie wszystkie żądania mają wysoki priorytet

priorityLevel?: PriorityLevel

Wartość właściwości

Dziedziczone zsharedOptions.priorityLevel

sessionToken

Włącza/wyłącza pobieranie statystyk związanych z limitem przydziału kontenera dokumentów dla żądań odczytu kontenera dokumentów.

sessionToken?: string

Wartość właściwości

string

Dziedziczone zsharedOptions.sessionToken