Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Important
Tipy k výkonu v tomto článku jsou určené jenom pro sadu Java SDK služby Azure Cosmos DB verze 4. Prohlédněte si poznámky k verzi sady Azure Cosmos DB Java SDK v4, úložiště Maven a průvodce odstraňováním potíží sady Azure Cosmos DB Java SDK v4 pro více informací. Pokud aktuálně používáte starší verzi než v4, nápovědu k upgradu na verzi 4 najdete v průvodci migrací do sady Java SDK služby Azure Cosmos DB verze 4.
Azure Cosmos DB je rychlá a flexibilní distribuovaná databáze, která se bezproblémově škáluje s garantovanou latencí a propustností. Nemusíte provádět významné změny architektury ani psát složitý kód pro škálování databáze pomocí Azure Cosmos DB. Vertikální navýšení a snížení kapacity je stejně snadné jako vytvoření jediného volání rozhraní API nebo volání metody sady SDK. Protože je ale služba Azure Cosmos DB přístupná prostřednictvím síťových volání, existují konfigurace připojení, které můžete vyladit, abyste dosáhli maximálního výkonu při použití sady Azure Cosmos DB Java SDK v4.
Konfigurace připojení
Note
V sadě Azure Cosmos DB Java SDK v4 je nejlepším řešením pro zlepšení výkonu databáze s většinou úloh přímý režim .
Další informace o různých možnostech připojení najdete v článku o režimech připojení.
Režim přímého připojení
Výchozí režim připojení sady Java SDK je přímý. Požadavky Azure Cosmos DB v přímém režimu se provádějí přes protokol TCP při použití sady Java SDK služby Azure Cosmos DB v4. Interní přímý režim používá speciální architekturu k dynamické správě síťových prostředků a zajištění nejlepšího výkonu. Architektura na straně klienta použitá v režimu Direct umožňuje předvídatelné využití sítě a multiplexovaný přístup k replikám služby Azure Cosmos DB. Další informace o architektuře najdete v architektuře přímého režimu připojení.
Režim připojení v tvůrci klienta můžete nakonfigurovat pomocí metody directMode(), jak je znázorněno zde. Chcete-li nakonfigurovat přímý režim s výchozím nastavením, volejte directMode() metodu bez argumentů. Pokud chcete přizpůsobit nastavení připojení v přímém režimu, předejte DirectConnectionConfig do directMode() rozhraní API.
Java SDK V4 (Maven com.azure::azure-cosmos) Async API
/* Direct mode, default settings */
CosmosAsyncClient clientDirectDefault = new CosmosClientBuilder()
.endpoint(HOSTNAME)
.key(MASTERKEY)
.consistencyLevel(CONSISTENCY)
.directMode()
.buildAsyncClient();
/* Direct mode, custom settings */
DirectConnectionConfig directConnectionConfig = DirectConnectionConfig.getDefaultConfig();
// Example config, do not use these settings as defaults
directConnectionConfig.setMaxConnectionsPerEndpoint(130);
directConnectionConfig.setIdleConnectionTimeout(Duration.ZERO);
CosmosAsyncClient clientDirectCustom = new CosmosClientBuilder()
.endpoint(HOSTNAME)
.key(MASTERKEY)
.consistencyLevel(CONSISTENCY)
.directMode(directConnectionConfig)
.buildAsyncClient();
/* Gateway mode, default settings */
CosmosAsyncClient clientGatewayDefault = new CosmosClientBuilder()
.endpoint(HOSTNAME)
.key(MASTERKEY)
.consistencyLevel(CONSISTENCY)
.gatewayMode()
.buildAsyncClient();
/* Gateway mode, custom settings */
GatewayConnectionConfig gatewayConnectionConfig = GatewayConnectionConfig.getDefaultConfig();
// Example config, do not use these settings as defaults
gatewayConnectionConfig.setProxy(new ProxyOptions(ProxyOptions.Type.HTTP, InetSocketAddress.createUnresolved("your.proxy.addr",80)));
gatewayConnectionConfig.setMaxConnectionPoolSize(1000);
CosmosAsyncClient clientGatewayCustom = new CosmosClientBuilder()
.endpoint(HOSTNAME)
.key(MASTERKEY)
.consistencyLevel(CONSISTENCY)
.gatewayMode(gatewayConnectionConfig)
.buildAsyncClient();
/* No connection mode, defaults to Direct mode with default settings */
CosmosAsyncClient clientDefault = new CosmosClientBuilder()
.endpoint(HOSTNAME)
.key(MASTERKEY)
.consistencyLevel(CONSISTENCY)
.buildAsyncClient();
Přizpůsobení režimu přímého připojení
Pokud je požadováno chování ne výchozího přímého režimu, vytvořte instanci DirectConnectionConfig a přizpůsobte její vlastnosti, následně předejte tuto přizpůsobenou instanci metodě directMode() v builderu klienta Azure Cosmos DB.
Tato nastavení konfigurace řídí chování základní architektury přímého režimu probírané dříve.
Jako první krok zde použijte následující doporučená nastavení konfigurace. Tyto možnosti DirectConnectionConfig jsou pokročilá nastavení konfigurace, která můžou ovlivnit výkon sady SDK neočekávanými způsoby; doporučujeme uživatelům vyhnout se jejich úpravám, pokud se nebudou cítit pohodlně pochopit kompromisy a je to nezbytné. Pokud narazíte na problémy s tímto konkrétním tématem, obraťte se na tým služby Azure Cosmos DB.
| Možnost konfigurace | Výchozí | Doporučeno | Details |
|---|---|---|---|
| časový limit nečinného připojení | "PT0" (NULA) | "PT0" (NULA) | Představuje dobu časového limitu nečinnosti připojení pro jedno připojení k koncovému nebo back-endovému uzlu (představující repliku). Sada SDK ve výchozím nastavení automaticky nezavírá nečinná připojení k back-endovým uzlům. |
| idleEndpointTimeout | "PT1H" | "PT1H" | Představuje dobu časového limitu nečinnosti pro připojení ve fondu připojení k určitému koncovému bodu nebo backendovému uzlu (který představuje repliku). Pokud na konkrétní koncový bod nebo back-endový uzel nejsou žádné příchozí požadavky, sada SDK ve výchozím nastavení zavře všechna připojení ve fondu připojení k uzlu koncového bodu nebo back-endu po 1 hodině, aby se ušetřily síťové prostředky a vstupně-výstupní náklady. U řídkých nebo sporadických přenosů doporučujeme tuto hodnotu nastavit na vyšší číslo, například 6 hodin, 12 hodin nebo dokonce 24 hodin, aby sada SDK nemusela často otevírat připojení. To ale využívá síťové prostředky a bude mít v daném okamžiku otevřený vyšší počet připojení. Pokud je tato hodnota nastavená na NULU, je kontrola nečinných koncových bodů zakázaná. |
| maximálníPočetPřipojeníNaKoncovýBod | "130" | "130" | Představuje horní mez fondu připojení pro koncový bod nebo backendový uzel (představující repliku). Sada SDK vytváří připojení ke koncovému nebo back-endovému uzlu na vyžádání a na základě příchozích souběžných požadavků. V případě potřeby sada SDK ve výchozím nastavení vytvoří maximálně 130 připojení ke koncovému nebo back-endovému uzlu. (POZNÁMKA: Sada SDK předem nevytvoří tato 130 připojení). |
| maxRequestsPerConnection | 30 | 30 | Představuje horní mez maximálního počtu požadavků, které je možné zařadit do fronty na jedno připojení pro konkrétní koncový nebo back-endový uzel (představující repliku). SDK zařadí požadavky na jedno připojení ke koncovému bodu nebo backendovému uzlu podle potřeby a na základě příchozích souběžných požadavků. V případě potřeby sada SDK ve výchozím nastavení zařadí do fronty maximálně 30 požadavků na jedno připojení pro konkrétní koncový bod nebo back-endový uzel. (POZNÁMKA: Sada SDK nezařadí těchto 30 požadavků na jedno připojení předem). |
| Připojovací časový limit (connectTimeout) | "PT5S" | "~PT1S" | To představuje dobu trvání časového limitu pro navázání připojení pro jedno připojení s koncovým bodem nebo back-endovým uzlem. Ve výchozím nastavení sada SDK čeká na vytvoření připojení maximálně 5 sekund před vyvoláním chyby. Připojení TCP používá vícestupňové navazování spojení, což zvyšuje latenci při navazování připojení, proto doporučujeme zákazníkům nastavit tuto hodnotu podle šířky pásma sítě a systémových nastavení. POZNÁMKA: Toto doporučení ~PT1S je určené pouze pro aplikace nasazené ve společně umístěných oblastech jejich Cosmos DB účtů. |
| networkRequestTimeout | "PT5S" | "PT5S" | Představuje dobu trvání časového limitu sítě pro jeden požadavek. Po zápisu požadavku do síťového připojení SDK počká na tuto dobu maximálně, než zpracuje odpověď ze služby. Sada SDK povoluje pouze hodnoty mezi 1 sekundou (min) a 10 sekundou (max). Nastavení příliš vysoké hodnoty může vést k menšímu počtu opakovaných pokusů a snížení pravděpodobnosti úspěchu opakovanými pokusy. |
Režim připojení brány
Operace řídicí roviny, jako jsou databáze a kontejnerové operace CRUD , vždy využívají režim brány. I když uživatel nakonfiguroval přímý režim pro operace roviny dat, řídicí rovina a operace s meta daty používají výchozí nastavení režimu brány. To vyhovuje většině uživatelů. Uživatelé, kteří však chtějí přímý režim pro operace roviny dat a možnosti ladění parametrů režimu brány řídicí roviny, mohou použít následující přepsání directMode():
Java SDK V4 (Maven com.azure::azure-cosmos) Async API
/* Independent customization of Direct mode data plane and Gateway mode control plane */
DirectConnectionConfig directConnectionConfig = DirectConnectionConfig.getDefaultConfig();
// Example config, do not use these settings as defaults
directConnectionConfig.setMaxConnectionsPerEndpoint(130);
directConnectionConfig.setIdleConnectionTimeout(Duration.ZERO);
GatewayConnectionConfig gatewayConnectionConfig = GatewayConnectionConfig.getDefaultConfig();
// Example config, do not use these settings as defaults
gatewayConnectionConfig.setProxy(new ProxyOptions(ProxyOptions.Type.HTTP, InetSocketAddress.createUnresolved("your.proxy.addr",80)));
gatewayConnectionConfig.setMaxConnectionPoolSize(1000);
CosmosAsyncClient clientDirectCustom = new CosmosClientBuilder()
.endpoint(HOSTNAME)
.key(MASTERKEY)
.consistencyLevel(CONSISTENCY)
.directMode(directConnectionConfig,gatewayConnectionConfig)
.buildAsyncClient();
Přizpůsobení režimu připojení brány
Pokud je žádoucí jiné než výchozí chování režimu brány, vytvořte instanci GatewayConnectionConfig, přizpůsobte její vlastnosti a poté předejte přizpůsobenou instanci metodě directMode() nebo gatewayMode() v builderu klienta Azure Cosmos DB.
Jako první krok zde použijte následující doporučená nastavení konfigurace. Tyto možnosti GatewayConnectionConfig jsou pokročilá nastavení konfigurace, která můžou ovlivnit výkon sady SDK neočekávanými způsoby; doporučujeme uživatelům vyhnout se jejich úpravám, pokud se nebudou cítit pohodlně pochopit kompromisy a je to nezbytné. Pokud narazíte na problémy s tímto konkrétním tématem, obraťte se na tým služby Azure Cosmos DB.
| Možnost konfigurace | Výchozí | Doporučeno | Details |
|---|---|---|---|
| maximální velikost poolu spojení | "1000" | "1000" | Představuje horní mez velikosti fondu připojení pro základního klienta HTTP, což je maximální počet připojení, která sada SDK vytváří pro požadavky směřující do režimu brány. Sada SDK tato připojení znovu použije při odesílání požadavků do brány. |
| časový limit nečinného připojení | "PT60S" | "PT60S" | Představuje dobu časového limitu nečinnosti připojení pro jedno připojení k bráně. Po této době bude síťové připojení automaticky uzavřeno a odstraněno z fondu připojení. |
Další kroky
Další informace o tipech pro zvýšení výkonu sady Java SDK najdete v tématu Tipy pro zvýšení výkonu pro sadu Java SDK služby Azure Cosmos DB verze 4.
Další informace o návrhu aplikace pro škálování a vysoký výkon najdete v tématu Dělení a škálování ve službě Azure Cosmos DB.
Pokoušíte se naplánovat kapacitu migrace do služby Azure Cosmos DB? Informace o stávajícím databázovém clusteru můžete použít k plánování kapacity.
- Pokud znáte pouze počet virtuálních jader a serverů ve vašem existujícím databázovém klastru, přečtěte si informace o odhadu jednotek žádostí pomocí virtuálních jader nebo virtuálních procesorů.
- Pokud znáte typické sazby požadavků pro vaši aktuální úlohu databáze, přečtěte si informace o odhadu jednotek žádostí pomocí plánovače kapacity služby Azure Cosmos DB.