Share via

Overzicht van de toegewezen gateway voor Azure Cosmos DB

  • Artikel

VAN TOEPASSING OP: NoSQL

Een toegewezen gateway is rekenkracht aan de serverzijde die een front-end is voor uw Azure Cosmos DB-account. Wanneer u verbinding maakt met de toegewezen gateway, worden aanvragen gerouteerd en worden gegevens in de cache opgeslagen. Net als ingerichte doorvoer wordt de toegewezen gateway elk uur gefactureerd.

Overzicht

U kunt een toegewezen gateway inrichten om de prestaties op schaal te verbeteren. De meest voorkomende reden dat u een toegewezen gateway wilt inrichten, is voor caching. Wanneer u een toegewezen gateway inricht, wordt een geïntegreerde cache automatisch geconfigureerd binnen de toegewezen gateway. Puntlees- en query's die op de geïntegreerde cache drukken, maken geen gebruik van uw RU's. Het inrichten van een toegewezen gateway met een geïntegreerde cache kan helpen de kosten voor leesintensieve workloads in Azure Cosmos DB te verlagen.

De toegewezen gateway is ingebouwd in Azure Cosmos DB. Wanneer u een toegewezen gateway inricht, hebt u een volledig beheerd knooppunt waarmee aanvragen worden gerouteerd naar back-endpartities. Verbinding maken met Azure Cosmos DB met de toegewezen gateway biedt een lagere en voorspelbarere latentie dan verbinding maken met Azure Cosmos DB met de standaardgateway. Zelfs cachemissers zien latentieverbeteringen bij het vergelijken van de toegewezen gateway en standaardgateway.

Er zijn slechts minimale codewijzigingen vereist om uw toepassing een toegewezen gateway te laten gebruiken. Nieuwe en bestaande Azure Cosmos DB-accounts kunnen een toegewezen gateway inrichten voor verbeterde leesprestaties.

Notitie

Hebt u feedback over de toegewezen gateway? We willen het horen! U kunt feedback rechtstreeks delen met het technische team van Azure Cosmos DB: cosmoscachefeedback@microsoft.com

Verbindingsmodi

Er zijn twee connectiviteitsmodi voor Azure Cosmos DB, directe modus en gatewaymodus. Met de gatewaymodus kunt u verbinding maken met de standaardgateway of de toegewezen gateway, afhankelijk van het eindpunt dat u configureert.

Diagram waarin wordt getoond hoe de connectiviteitsmodi van Azure Cosmos DB werken.

Verbinding maken met Azure Cosmos DB met behulp van de directe modus

Wanneer u verbinding maakt met Azure Cosmos DB via de directe modus, maakt uw toepassing rechtstreeks verbinding met de Azure Cosmos DB-back-end. Zelfs als u veel fysieke partities hebt, wordt aanvraagroutering volledig verwerkt aan de clientzijde. De directe modus biedt lage latentie omdat uw toepassing rechtstreeks kan communiceren met de Back-end van Azure Cosmos DB en geen tussenliggende netwerkhop nodig heeft. Als u ervoor kiest om verbinding te maken met de directe modus, worden uw aanvragen niet gebruikt voor de toegewezen gateway of de geïntegreerde cache.

Verbinding maken met Azure Cosmos DB met behulp van de gatewaymodus

Als u verbinding maakt met Azure Cosmos DB via de gatewaymodus, maakt uw toepassing eerst verbinding met een front-endknooppunt, waarmee de aanvraag wordt doorgestuurd naar de juiste back-endknooppunten. Omdat de gatewaymodus een extra netwerkhop omvat, ziet u mogelijk iets hogere latentie in vergelijking met de directe modus.

Wanneer u verbinding maakt met Azure Cosmos DB met de gatewaymodus, kunt u verbinding maken met een van de volgende opties:

  • Standaardgateway : terwijl de back-end, die uw ingerichte doorvoer en opslag omvat, toegewezen capaciteit per container heeft, wordt de standaardgateway gedeeld tussen veel Azure Cosmos DB-accounts. Het is praktisch voor veel klanten om een standaardgateway te delen, omdat de rekenresources die door elke afzonderlijke klant worden verbruikt, klein zijn.
  • Toegewezen gateway: in deze gateway hebben de back-end en gateway beide toegewezen capaciteit. Voor de geïntegreerde cache is een toegewezen gateway vereist, omdat er aanzienlijke CPU en geheugen nodig zijn die specifiek zijn voor uw Azure Cosmos DB-account.

U moet verbinding maken met Azure Cosmos DB met behulp van de toegewezen gateway om de geïntegreerde cache te kunnen gebruiken. De toegewezen gateway heeft een ander eindpunt dan het standaard-eindpunt dat bij uw Azure Cosmos DB-account wordt geleverd, maar aanvragen worden op dezelfde manier gerouteerd. Wanneer u verbinding maakt met uw toegewezen gateway-eindpunt, verzendt uw toepassing een aanvraag naar de toegewezen gateway, die de aanvraag vervolgens doorstuurt naar verschillende back-endknooppunten. Indien mogelijk dient de geïntegreerde cache het resultaat.

Diagram van de gatewaymodusverbinding met een toegewezen gateway:

Diagram waarin wordt getoond hoe de toegewezen Gateway van Azure Cosmos DB werkt.

De toegewezen gateway inrichten

Een toegewezen gatewaycluster kan worden ingericht in API voor NoSQL-accounts. Een toegewezen gatewaycluster kan standaard maximaal vijf knooppunten bevatten en u kunt knooppunten op elk gewenst moment toevoegen of verwijderen. Alle toegewezen gatewayknooppunten binnen uw account delen hetzelfde toegewezen gateway-eindpunt.

Toegewezen gatewayknooppunten zijn onafhankelijk van elkaar. Wanneer u meerdere toegewezen gatewayknooppunten inricht, kan elk willekeurig knooppunt elke aanvraag routeren. Bovendien heeft elk knooppunt een afzonderlijke geïntegreerde cache van de andere knooppunten. De gegevens in de cache binnen elk knooppunt zijn afhankelijk van de gegevens die onlangs zijn geschreven of gelezen door dat specifieke knooppunt. Als een item of query op één knooppunt in de cache wordt opgeslagen, is het niet noodzakelijkerwijs in de cache opgeslagen op de andere knooppunten.

Voor ontwikkeling raden we u aan om te beginnen met één knooppunt, maar voor productie moet u drie of meer knooppunten inrichten voor hoge beschikbaarheid. Meer informatie over het inrichten van een toegewezen gatewaycluster met een geïntegreerde cache. Door meerdere toegewezen gatewayknooppunten in te richten, kan het toegewezen gatewaycluster aanvragen blijven routeren en gegevens in de cache verwerken, zelfs wanneer een van de toegewezen gatewayknooppunten niet beschikbaar is.

De toegewezen gateway is beschikbaar in de volgende grootten. De geïntegreerde cache gebruikt ongeveer 50% van het geheugen en de rest is gereserveerd voor metagegevens en routeringsaanvragen naar back-endpartities.

SKU-naam vCPU Geheugen
D4s 4 16 GB
D8s 8 32 GB
D16s 16 64 GB

Tip

Nadat u de gateway hebt gemaakt, kunt u toegewezen gatewayknooppunten toevoegen of verwijderen, maar u kunt de grootte van de knooppunten niet wijzigen. Als u de grootte van uw toegewezen gatewayknooppunten wilt wijzigen, kunt u de inrichting van het cluster ongedaan maken en het opnieuw inrichten in een andere grootte. Dit leidt tot een korte downtime, tenzij u het eindpunt in uw toepassing wijzigt om de standaardgateway te gebruiken tijdens het opnieuw inrichten.

Er zijn veel verschillende manieren om een toegewezen gateway in te richten:

Notitie

U kunt per aanvraag een toegewezen gateway inrichten in Azure Cosmos DB-accounts met beschikbaarheidszones . Neem contact op met cosmoscachefeedback@microsoft.com voor meer info.

Toegewezen gateway in accounts met meerdere regio's

Wanneer u een toegewezen gatewaycluster inricht in accounts met meerdere regio's, worden identieke toegewezen gatewayclusters ingericht in elke regio. Denk bijvoorbeeld aan een Azure Cosmos DB-account in VS - oost en Europa - noord. Als u een toegewezen gatewaycluster inricht met twee D8-knooppunten in dit account, hebt u in totaal vier D8-knooppunten: twee in VS - oost en twee in Europa - noord. U hoeft niet expliciet toegewezen gateways in elke regio te configureren en uw toegewezen gateway-eindpunt blijft hetzelfde. Er zijn ook geen wijzigingen in aanbevolen procedures voor het uitvoeren van failovers.

Net als knooppunten binnen een cluster zijn toegewezen gatewayknooppunten in verschillende regio's onafhankelijk. Het is mogelijk dat de gegevens in de cache in elke regio verschillen, afhankelijk van de recente lees- of schrijfbewerkingen naar die regio.

Beperkingen

Toegewezen gateways worden alleen ondersteund op API voor NoSQL-accounts.

Volgende stappen

Lees meer over toegewezen gatewaygebruik in de volgende artikelen: