Automatikus skálázási átviteli sebesség kiépítése adatbázison vagy tárolón az Azure Cosmos DB-ben – API for NoSQL
A KÖVETKEZŐRE VONATKOZIK: NoSQL
Ez a cikk azt ismerteti, hogyan építhet ki automatikus skálázási átviteli sebességet egy adatbázisra vagy tárolóra (gyűjteményre, gráfra vagy táblára) az Azure Cosmos DB for NoSQL-ben. Engedélyezheti az automatikus skálázást egyetlen tárolón, vagy automatikus skálázási átviteli sebességet helyezhet üzembe egy adatbázisban, és megoszthatja az adatbázis összes tárolója között.
Ha másik API-t használ, tekintse meg a MongoDB API-t, a Cassandra API-t és a Gremlin-cikkekhez készült API-t az átviteli sebesség kiépítéséhez.
Azure Portal
Új adatbázis vagy tároló létrehozása automatikus skálázással
Jelentkezzen be az Azure Portalra vagy az Azure Cosmos DB Explorerbe.
Lépjen az Azure Cosmos DB-fiókjára, és nyissa meg az Adatkezelő lapot.
Válassza az Új tároló lehetőséget . Adja meg az adatbázis, a tároló és a partíciókulcs nevét. Az adatbázis vagy a tároló átviteli sebességében válassza az Automatikus skálázás lehetőséget, és állítsa be azt a maximális átviteli sebességet (RU/s), amellyel az adatbázist vagy tárolót skálázni szeretné.
Kattintson az OK gombra.
Ha automatikus skálázást szeretne kiépíteni a megosztott átvitelisebesség-adatbázison, új adatbázis létrehozásakor válassza az Adatbázis átviteli sebességének kiépítése lehetőséget.
Automatikus skálázás engedélyezése meglévő adatbázison vagy tárolón
Jelentkezzen be az Azure Portalra vagy az Azure Cosmos DB Explorerbe.
Lépjen az Azure Cosmos DB-fiókjára, és nyissa meg az Adatkezelő lapot.
Válassza a tároló méretezése és beállításai , illetve az adatbázis méretezése lehetőséget.
A Méretezés csoportban válassza az Automatikus skálázás és a Mentés lehetőséget.
Feljegyzés
Ha egy meglévő adatbázison vagy tárolón engedélyezi az automatikus skálázást, a maximális RU/s kezdőértékét a rendszer határozza meg az aktuális manuális kiosztott átviteli sebesség beállításai és tárhelye alapján. A művelet befejezése után szükség esetén módosíthatja a maximális RU/s értéket. További információ.
Azure Cosmos DB .NET V3 SDK
Az automatikus skálázási erőforrások kezeléséhez használja az Azure Cosmos DB .NET SDK for API for NoSQL 3.9-es vagy újabb verzióját.
Fontos
A .NET SDK-val új automatikus skálázási erőforrásokat hozhat létre. Az SDK nem támogatja az automatikus skálázás és a standard (manuális) átviteli sebesség közötti migrálást. A migrálási forgatókönyv jelenleg csak az Azure Portalon, a parancssori felületen és a PowerShellben támogatott.
Adatbázis létrehozása megosztott átviteli sebességgel
// Create instance of CosmosClient
CosmosClient cosmosClient = new CosmosClient(Endpoint, PrimaryKey);
// Autoscale throughput settings
ThroughputProperties autoscaleThroughputProperties = ThroughputProperties.CreateAutoscaleThroughput(1000); //Set autoscale max RU/s
//Create the database with autoscale enabled
database = await cosmosClient.CreateDatabaseAsync(DatabaseName, throughputProperties: autoscaleThroughputProperties);
Tároló létrehozása dedikált átviteli sebességgel
// Get reference to database that container will be created in
Database database = await cosmosClient.GetDatabase("DatabaseName");
// Container and autoscale throughput settings
ContainerProperties autoscaleContainerProperties = new ContainerProperties("ContainerName", "/partitionKey");
ThroughputProperties autoscaleThroughputProperties = ThroughputProperties.CreateAutoscaleThroughput(1000); //Set autoscale max RU/s
// Create the container with autoscale enabled
container = await database.CreateContainerAsync(autoscaleContainerProperties, autoscaleThroughputProperties);
Az aktuális átviteli sebesség (RU/s) olvasása
// Get a reference to the resource
Container container = cosmosClient.GetDatabase("DatabaseName").GetContainer("ContainerName");
// Read the throughput on a resource
ThroughputProperties autoscaleContainerThroughput = await container.ReadThroughputAsync(requestOptions: null);
// The autoscale max throughput (RU/s) of the resource
int? autoscaleMaxThroughput = autoscaleContainerThroughput.AutoscaleMaxThroughput;
// The throughput (RU/s) the resource is currently scaled to
int? currentThroughput = autoscaleContainerThroughput.Throughput;
Az automatikus skálázás maximális átviteli sebességének (RU/s) módosítása
// Change the autoscale max throughput (RU/s)
await container.ReplaceThroughputAsync(ThroughputProperties.CreateAutoscaleThroughput(newAutoscaleMaxThroughput));
Azure Cosmos DB Java V4 SDK
A NoSQL-hez készült Azure Cosmos DB Java SDK for API 4.0-s vagy újabb verziójával kezelheti az automatikus skálázási erőforrásokat.
Fontos
A Java SDK-val új automatikus skálázási erőforrásokat hozhat létre. Az SDK nem támogatja az automatikus skálázás és a standard (manuális) átviteli sebesség közötti migrálást. A migrálási forgatókönyv jelenleg csak az Azure Portalon, a parancssori felületen és a PowerShellben támogatott.
Adatbázis létrehozása megosztott átviteli sebességgel
// Create instance of CosmosClient
CosmosAsyncClient client = new CosmosClientBuilder()
.setEndpoint(HOST)
.setKey(PRIMARYKEY)
.setConnectionPolicy(CONNECTIONPOLICY)
.buildAsyncClient();
// Autoscale throughput settings
ThroughputProperties autoscaleThroughputProperties = ThroughputProperties.createAutoscaledThroughput(1000); //Set autoscale max RU/s
//Create the database with autoscale enabled
CosmosAsyncDatabase database = client.createDatabase(databaseName, autoscaleThroughputProperties).block().getDatabase();
Tároló létrehozása dedikált átviteli sebességgel
// Get reference to database that container will be created in
CosmosAsyncDatabase database = client.createDatabase("DatabaseName").block().getDatabase();
// Container and autoscale throughput settings
CosmosContainerProperties autoscaleContainerProperties = new CosmosContainerProperties("ContainerName", "/partitionKey");
ThroughputProperties autoscaleThroughputProperties = ThroughputProperties.createAutoscaledThroughput(1000); //Set autoscale max RU/s
// Create the container with autoscale enabled
CosmosAsyncContainer container = database.createContainer(autoscaleContainerProperties, autoscaleThroughputProperties, new CosmosContainerRequestOptions())
.block()
.getContainer();
Az aktuális átviteli sebesség (RU/s) olvasása
// Get a reference to the resource
CosmosAsyncContainer container = client.getDatabase("DatabaseName").getContainer("ContainerName");
// Read the throughput on a resource
ThroughputProperties autoscaleContainerThroughput = container.readThroughput().block().getProperties();
// The autoscale max throughput (RU/s) of the resource
int autoscaleMaxThroughput = autoscaleContainerThroughput.getAutoscaleMaxThroughput();
// The throughput (RU/s) the resource is currently scaled to
int currentThroughput = autoscaleContainerThroughput.Throughput;
Az automatikus skálázás maximális átviteli sebességének (RU/s) módosítása
// Change the autoscale max throughput (RU/s)
container.replaceThroughput(ThroughputProperties.createAutoscaledThroughput(newAutoscaleMaxThroughput)).block();
Azure Resource Manager
Az Azure Resource Manager-sablonok segítségével automatikus skálázási átviteli sebességet építhet ki egy új adatbázisra vagy tárolószintű erőforrásra az összes Azure Cosmos DB API-hoz. Példákért tekintse meg az Azure Cosmos DB Azure Resource Manager-sablonjait. Terv szerint az Azure Resource Manager-sablonok nem használhatók a meglévő erőforrások kiépített és automatikus skálázási átviteli sebessége közötti migrálásra.
Azure CLI
Az Azure CLI-vel automatikus skálázási átviteli sebességet építhet ki egy új adatbázisra vagy tárolószintű erőforrásra az összes Azure Cosmos DB API-hoz, vagy engedélyezheti az automatikus skálázást egy meglévő erőforráson. A mintákért tekintse meg az Azure Cosmos DB-hez készült Azure CLI-mintákat.
Azure PowerShell
Az Azure PowerShell használatával automatikus skálázási átviteli sebességet építhet ki egy új adatbázisra vagy tárolószintű erőforrásra az összes Azure Cosmos DB API-hoz, vagy engedélyezheti az automatikus skálázást egy meglévő erőforráson. A mintákért tekintse meg az Azure Cosmos DB-hez készült Azure PowerShell-mintákat.
Következő lépések
- Ismerje meg a kiosztott átviteli sebesség és az automatikus skálázás előnyeit.
- Megtudhatja, hogyan választhat a manuális és az automatikus skálázási átviteli sebesség között.
- Tekintse át az automatikus skálázási gyakori kérdéseket.