Az Azure Cosmos DB konfigurálása a NoSQL-hez materializált nézetekhez (előzetes verzió)

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Fontos

Az Azure Cosmos DB for NoSQL materializált nézetei jelenleg előzetes verzióban érhetők el. Ezt a funkciót az Azure Portalon engedélyezheti. Ez az előzetes verzió szolgáltatásszintű szerződés nélkül érhető el. Jelenleg nem javasoljuk, hogy materializált nézeteket használjon éles számítási feladatokhoz. Előfordulhat, hogy az előzetes verzió bizonyos funkciói nem támogatottak, vagy korlátozott képességekkel rendelkeznek. További információkért tekintse meg a Microsoft Azure előzetes verziójának használati feltételeit.

A materializált nézetek hatékony módot nyújtanak a lekérdezési teljesítmény optimalizálására és az alkalmazáslogika egyszerűsítésére azáltal, hogy más partíciókulcsot és/vagy adatmodellt használva hoznak létre nézeteket az adatokról. Ez a cikk bemutatja, hogyan hozhat létre materializált nézeteket, és hogyan kezelheti hatékonyan a partíciók közötti lekérdezéseket.

Előfeltételek

• Egy meglévő Azure Cosmos DB-fiók.
  • Ha Rendelkezik Azure-előfizetéssel, hozzon létre egy új fiókot.
  • Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
  • Másik lehetőségként a véglegesítés előtt ingyenesen kipróbálhatja az Azure Cosmos DB-t.

Materializált nézetek engedélyezése

A materialized views funkciót engedélyezni kell az Azure Cosmos DB-fiókhoz egy szerkesztő kiépítése vagy nézetek létrehozása előtt.

Azure Portal

1. Jelentkezzen be az Azure Portalra.

2. Nyissa meg az Azure Cosmos DB for NoSQL-fiókját.

3. Az erőforrás menüjében válassza a Beállítások lehetőséget.

4. A Beállítások területen állítsa a Materialized View for NoSQL API (előzetes verzió) beállítást Be értékre.

5. Az új párbeszédpanelen válassza az Engedélyezés lehetőséget a funkció fiókhoz való engedélyezéséhez.

Azure CLI

Az Azure CLI használatával engedélyezheti a materializált nézetek funkciót egy natív paranccsal vagy egy REST API-művelettel az Azure Cosmos DB for NoSQL-fiókon.

1. Jelentkezzen be az Azure CLI-be.

   az login
   

   Megjegyzés

   Ehhez az Azure CLI szükséges, és megtudhatja , hogyan telepítheti az Azure CLI-t.

2. Adja meg a meglévő Azure Cosmos DB for NoSQL-fiók erőforráscsoportjának és fióknevének változóit.

   # Variable for resource group name
   $resourceGroupName="<resource-group-name>"
   
   # Variable for account name
   $accountName="<account-name>"
   
   # Variable for Azure subscription
   $subscriptionId="<subscription-id>"
   

3. Hozzon létre egy capabilities.json nevű új JSON-fájlt a képességjegyzék használatával.

   {
     "properties": {
       "enableMaterializedViews": true
     }
   }
   

4. Kérje le a fiók azonosítóját, és tárolja egy névvel ellátott $accountIdrendszerhéjváltozóban.

   $accountId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/$accountName"
   

5. Engedélyezze a fiók előzetes materializált nézet funkcióját a REST API és az az rest használatával EGY HTTP-paranccsal PATCH .

   az rest \
       --method PATCH \
       --uri "https://management.azure.com/$accountId/?api-version=2022-11-15-preview" \
       --body @capabilities.json
   

Materializált nézetszerkesztő létrehozása

Miután engedélyezte a materializált nézetek funkciót a fiókjához, megjelenik egy új lap az Azure Portal For Materialized Views Builder Beállítások szakaszában. A nézetek létrehozása előtt ki kell építenie egy materializált nézetkészítőt a fiókjában. A szerkesztő feladata az adatok automatikus hidratálása a nézetekben, és azok szinkronban tartása a forrástárolókkal. További információ a materializált nézetszerkesztő kiépítésének lehetőségeiről.

Azure Portal

1. Jelentkezzen be az Azure Portalra.

2. Nyissa meg az Azure Cosmos DB for NoSQL-fiókját.

3. Az erőforrásmenüben válassza a Materialized Views Builder lehetőséget.

4. A Materialized Views Builder lapon konfigurálja az SKU-t és a készítő példányainak számát.

   Megjegyzés

   Ez az erőforrásmenü-beállítás és lap csak akkor jelenik meg, ha a materializált nézetek funkció engedélyezve van a fiókhoz.

5. Válassza a Mentés lehetőséget.

Azure CLI

1. Adja meg a meglévő Azure Cosmos DB for NoSQL-fiók erőforráscsoportjának és fióknevének változóit.

   # Variable for resource group name
   $resourceGroupName="<resource-group-name>"
   
   # Variable for account name
   $accountName="<account-name>"
   
   # Variable for Azure subscription
   $subscriptionId="<subscription-id>"
   

2. Hozzon létre egy builder.json nevű új JSON-fájlt a szerkesztőjegyzék használatával. Frissítse az instanceCount és instanceSize szükség szerint.

   {
     "properties": {
       "serviceType": "materializedViewsBuilder",
       "instanceCount": 1,
       "instanceSize": "Cosmos.D4s"
     }
   }
   

3. Kérje le a fiók azonosítóját, és tárolja egy névvel ellátott $accountIdrendszerhéjváltozóban.

   $accountId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/$accountName"
   

4. Engedélyezze a materializált nézetszerkesztőt a fiókhoz a REST API-val és az rest egy HTTP-paranccsal PUT :

   az rest \
       --method PUT \
       --uri "https://management.azure.com$accountId/services/materializedViewsBuilder/?api-version=2022-11-15-preview" \
       --body @builder.json
   

5. Várjon néhány percet, majd ellenőrizze az állapotot a HTTP-parancs GET ismételt használatávalaz rest. A kimenet állapotának most már a következőnek kell lennie Running: .

   az rest \
       --method GET \
       --uri "https://management.azure.com$accountId/services/materializedViewsBuilder/?api-version=2022-11-15-preview"
   

Materializált nézet létrehozása

A funkció engedélyezése és a materializált nézetszerkesztő kiépítése után a REST API használatával materializált nézeteket hozhat létre.

1. Az Azure Portal, az Azure SDK-k, az Azure CLI vagy a REST API használatával hozzon létre egy forrástárolót, amely partíciókulcs-elérési útként szolgál /customerId . Nevezze el ezt a forrástárolót mv-src.

   Megjegyzés

   A /customerId mező csak példaként használatos ebben a cikkben. Saját tárolóihoz válasszon egy partíciókulcsot, amely a megoldáshoz használható.

2. Szúrjon be néhány elemet a forrástárolóba. Az ebben a cikkben bemutatott példák követéséhez győződjön meg arról, hogy az elemek rendelkeznek customerId és emailAddress mezőkkel. A mintaelem a következőképpen nézhet ki:

   {
     "id": "eaf0338e-2b61-4163-822f-7bef75bf51de",
     "customerId": "36c7cc3d-1709-45c6-819f-10e5586a6cb7",
     "emailAddress": "justine@contoso.com",
     "name": "Justine"
   }
   

   Megjegyzés

   Ebben a példában a forrástárolót mintaadatokkal tölti fel, mielőtt hozzáad egy nézetet. Egy materializált nézetet üres forrástárolóból is létrehozhat.

3. Most hozzon létre egy materializált nézetet, amely a forrástárolótól eltérő partíciókulcs-elérési úttal van elnevezve mv-target . Ebben a példában adja meg /emailAddress a tároló partíciókulcs-elérési mv-target útját.

   1. Hozzon létre egy definíciójegyzéket egy materializált nézethez, és mentse egy mv-definition.json nevű JSON-fájlba:

      {
        "location": "North Central US",
        "tags": {},
        "properties": {
          "resource": {
            "id": "mv-target",
            "partitionKey": {
              "paths": [
                "/emailAddress"
              ]
            },
            "materializedViewDefinition": {
              "sourceCollectionId": "mv-src",
              "definition": "SELECT c.customerId, c.emailAddress FROM c"
            }
          },
          "options": {
            "throughput": 400
          }
        }
      }        
      

   Fontos

   A sablonban figyelje meg, hogy a partíciókulcs elérési útja a következőképpen van beállítva /emailAddress. A sourceCollectionId nézet forrástárolóját határozza meg, és a definition nézet adatmodelljének meghatározására szolgáló lekérdezést tartalmaz. További információ a materializált nézetek és a lekérdezési korlátozások meghatározásáról.

   A materialized view source container and definition query nem módosítható a létrehozás után.

4. Ezután hozzon létre egy REST API-hívást a materializált nézet létrehozásához a mv-definition.json fájlban meghatározott módon. Az Azure CLI használatával kezdeményezhet REST API-hívást.

   1. Hozzon létre egy változót a materializált nézet és a forrásadatbázis nevéhez:

      # This should match the resource ID you defined in your json file
      $materializedViewName = "mv-target"
      
      # Database name for the source and view containers
      $databaseName = "<Database that contains source container>"
      
      # Azure Cosmos DB account name
      $accountName = "<Azure Cosmos DB account name>"
      
      # Resource name for your Azure Cosmos DB account
      $resourceGroupName = "<Resource group for Azure Cosmos DB account>"
      
      # Subscription id for your Azure Cosmos DB account
      $subscriptionId = "<Subscription id>"
      

   2. Ezeket a változókat használva hozza létre az erőforrás-azonosítót.

      $accountId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/$accountName"
      

   3. Hozzon létre egy REST API-hívást a materializált nézet létrehozásához:

      az rest \
          --method PUT \
          --uri "https://management.azure.com$accountId/sqlDatabases/ \
                $databaseName/containers/$materializedViewName/?api-version=2022-11-15-preview" \
          --body @mv-definition.json \
          --headers content-type=application/json
      

   4. Ellenőrizze a materializált nézettároló létrehozásának állapotát a REST API használatával:

      az rest \
          --method GET \
          --uri "https://management.azure.com$accountId/sqlDatabases/
                $databaseName/containers/$materializedViewName/?api-version=2022-11-15-preview" \
          --headers content-type=application/json \
          --query "{mvCreateStatus: properties.Status}"
      

5. A materializált nézet létrehozása után a materializált nézetszerkesztő automatikusan szinkronizálja a módosításokat a forrástárolóval. Próbálja meg végrehajtani a létrehozási, frissítési és törlési műveleteket a forrástárolóban. Ugyanazokat a módosításokat fogja látni, mint a materializált nézettárolóban.

Adatok lekérdezése materializált nézetekből

Ebben a példában van egy forrástároló particionálása customerId , és egy nézet particionálása a következőn emailAddress: . A nézet nélkül azok a lekérdezések, amelyek csak a emailAddress keresztpartíciót tartalmazzák, most már a nézeten keresztül is végrehajthatók a hatékonyság növelése érdekében.

Az adatok materializált nézetekből való lekérdezése hasonló bármely más tároló adatainak lekérdezéséhez. Az Azure Portal, az Azure SDK-k vagy a REST API használatával adatokat kérdezhet le materializált nézetekben.

.NET

Container container = client.GetDatabase("mv-db").GetContainer("mv-target");

FeedIterator<MyClass> myQuery = container.GetItemQueryIterator<MyClass>(new QueryDefinition("SELECT * FROM c WHERE c.emailAddress = 'justine@contoso.com'"));

Java

CosmosAsyncDatabase container = client.getDatabase("mv-db");
CosmosAsyncContainer container = database.getContainer("mv-target");

CosmosPagedFlux<MyClass> pagedFluxResponse = container.queryItems(
        "SELECT * FROM c WHERE c.emailAddress = 'justine@contoso.com'", null, MyClass.class);

Node.js

const database = client.database("mv-db");
const container = database.container("mv-target");

const querySpec = {
    query: "SELECT * FROM c WHERE c.emailAddress = 'justine@contoso.com'"
 };
const { resources: items } = await container.items
    .query(querySpec)
    .fetchAll();

Python

database = client.get_database_client("mv-db")
container = database.get_container_client("mv-target")

query = "SELECT * FROM c WHERE c.emailAddress = 'justine@contoso.com'"
container.query_items(
    query=query
)

Következő lépések

Az adatmodellezés és a materializált nézetek particionálása– áttekintés