Gyorsútmutató: Cassandra-alkalmazás létrehozása a .NET SDK és az Azure Cosmos DB használatával

A KÖVETKEZŐKRE VONATKOZIK: Cassandra API

Ez a rövid útmutató bemutatja, hogyan használhatja a .NET-et és az Azure Cosmos DB Cassandra API-t profilalkalmazás létrehozásához a GitHubról származó példa klónozásával. Ez a rövid útmutató emellett azt is bemutatja, hogyan hozható létre egy Azure Cosmos DB-fiók a webes alapú Azure Portalon.

Az Azure Cosmos DB a Microsoft globálisan elosztott többmodelles adatbázis-szolgáltatása. Segítségével gyorsan létrehozhat és lekérdezhet dokumentum, tábla, kulcs-érték és gráf típusú adatbázisokat, amelyek mindegyike felhasználja az Azure Cosmos DB középpontjában álló globális elosztási és horizontális skálázhatósági képességeket.

Előfeltételek

Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes Azure-fiókot . Alternatív lehetőségként kipróbálhatja ingyenesen az Azure Cosmos DB-t Azure-előfizetés, díjfizetés és elköteleződés nélkül.

Emellett szüksége lesz a következőkre:

  • A legújabb Visual Studio az Azure fejlesztési számítási feladattal. Az ingyenesVisual Studio Community IDE használatbavételéhez. Engedélyezze az Azure-fejlesztési számítási feladatot a Visual Studio beállítása során.
  • Telepítse a Git szoftvert a példa klónozásához.

Adatbázisfiók létrehozása

  1. A Azure Portal menüben vagy a kezdőlapon válassza az Erőforrás létrehozása lehetőséget.

  2. Az Új lapon keresse meg és válassza ki az Azure Cosmos DB-t.

  3. Az Azure Cosmos DB oldalán válassza a Létrehozás lehetőséget.

  4. Az Azure Cosmos DB-fiók létrehozása lapon adja meg az új Azure Cosmos-fiók alapvető beállításait.

    Beállítás Érték Leírás
    Előfizetés Az Ön előfizetése Válassza ki az Azure Cosmos DB-fiókhoz használni kívánt Azure-előfizetést.
    Erőforráscsoport Új létrehozása

    Ezután adja meg ugyanazt a nevet, mint a fióknév
    Válassza az Új létrehozása lehetőséget. Ezután adja meg a fiók új erőforráscsoport-nevét. Az egyszerűség kedvéért használja ugyanazt a nevet, mint az Azure Cosmos-fiók neve.
    Fiók neve Adjon meg egy egyedi nevet Adjon meg egy egyedi nevet az Azure Cosmos DB-fiók azonosításához. A fiók URI-ját a rendszer cassandra.cosmos.azure.com hozzáfűzi az egyedi fiók nevéhez.

    A fióknév csak kisbetűket, számokat és kötőjeleket (-) tartalmazhat, és 3–31 karakter hosszúságúnak kell lennie.
    API Cassandra A létrehozni kívánt fiók típusát az API határozza meg. Az Azure Cosmos DB öt API-t biztosít: Core (SQL) dokumentum-adatbázisokhoz, Gremlin gráfadatbázisokhoz, MongoDB dokumentum-adatbázisokhoz, Azure Table és Cassandra. Minden API-hoz külön fiókot kell létrehoznia.

    Válassza a Cassandra lehetőséget, mert ebben a rövid útmutatóban egy olyan táblát hoz létre, amely a Cassandra API-val működik.

    További információ a Cassandra API-ról.
    Hely A felhasználókhoz legközelebb eső régió Válassza ki az Azure Cosmos DB-fiókot üzemeltetéséhez használni kívánt földrajzi helyet. Használja a felhasználókhoz legközelebbi helyet, hogy a lehető leggyorsabb hozzáférést biztosítsa számukra az adatokhoz.
    Kapacitásmód Kiosztott átviteli sebesség vagy kiszolgáló nélküli A kiosztott átviteli sebesség kiválasztásával hozzon létre egy fiókot kiosztott átviteli módban. Kiszolgáló nélküli módban a kiszolgáló nélküli fiók létrehozásához válassza a Kiszolgáló nélküli lehetőséget.
    Az Azure Cosmos DB ingyenes szintű kedvezményének alkalmazása Alkalmaz vagy Nincs alkalmazva Az Ingyenes Azure Cosmos DB-szinttel az első 1000 RU/s és 25 GB tárterületet kapja meg ingyenesen egy fiókban. További információ az ingyenes szintről.

    Megjegyzés

    Azure-előfizetésenként legfeljebb egy ingyenes szintű Azure Cosmos DB-fiókkal rendelkezhet, és a fiók létrehozásakor be kell azt állítania. Ha nem látja az ingyenes szintű kedvezmény alkalmazásának lehetőségét, az azt jelenti, hogy az előfizetés egy másik fiókja már engedélyezve van az ingyenes szinttel.

    Az Azure Cosmos DB Cassandra API új fiókoldala

  5. A Globális terjesztés lapon konfigurálja az alábbi adatokat. Ebben a rövid útmutatóban az alapértelmezett értékeket meghagyhatja:

    Beállítás Érték Leírás
    Georedundancia Letiltás A globális terjesztés engedélyezéséhez vagy letiltásához párosítsa a régiót egy párrégióval. Később további régiókat is hozzáadhat a fiókjához.
    Többrégiós írók Letiltás A többrégiós írási képesség lehetővé teszi, hogy kihasználja a kiosztott átviteli sebességet az adatbázisok és tárolók számára világszerte.

    Megjegyzés

    A következő beállítások nem érhetők el, ha a Kiszolgáló nélkülikapacitás módot választja:

    • Az ingyenes szint árengedményének alkalmazása
    • Georedundancia
    • Többrégiós írók
  6. Igény szerint további részleteket is konfigurálhat az alábbi lapokon:

    • Hálózatkezelés – Virtuális hálózatról való hozzáférés konfigurálása.
    • Biztonsági mentési szabályzatRendszeres vagy folyamatos biztonsági mentési szabályzat konfigurálása.
    • Titkosítás – Szolgáltatás által felügyelt vagy ügyfél által felügyelt kulcs használata.
    • Címkék – A címkék név-érték párok, amelyek lehetővé teszik az erőforrások kategorizálását és az összevont számlázás megtekintését azáltal, hogy ugyanazt a címkét több erőforrásra és erőforráscsoportra alkalmazza.
  7. Válassza az Áttekintés + létrehozás lehetőséget.

  8. Tekintse át a fiókbeállításokat, majd válassza a Létrehozás lehetőséget. A fiók létrehozása néhány percet vesz igénybe. Várja meg, amíg a portáloldal megjelenik Az üzembe helyezés befejeződött.

    Az Azure Portal Értesítések panelje

  9. Válassza az Erőforrás megnyitása lehetőséget az Azure Cosmos DB-fiók oldalának megtekintéséhez.

A mintaalkalmazás klónozása

Most pedig váltsunk át kódok használatára. A következő lépésekben elvégezheti a Cassandra API-alkalmazás klónozását a GitHubról, beállíthatja a kapcsolati sztringet, és futtathatja az alkalmazást. Látni fogja, hogy milyen egyszerűen dolgozhat programozott módon az adatokkal.

  1. Nyisson meg egy parancssort. Hozzon létre egy git-samples nevű mappát. Ezután zárja be a parancssort.

    md "C:\git-samples"
    
  2. Nyisson meg egy git terminálablakot, például a git bash eszközt, és a cd parancs használatával váltson az új mappára, ahol telepíteni szeretné a mintaalkalmazást.

    cd "C:\git-samples"
    
  3. Futtassa a következő parancsot a mintatárház klónozásához. Ez a parancs másolatot hoz létre a mintaalkalmazásról az Ön számítógépén.

    git clone https://github.com/Azure-Samples/azure-cosmos-db-cassandra-dotnet-getting-started.git
    
  4. Ezután nyissa meg a CassandraQuickStartSample megoldásfájlt a Visual Studióban.

A kód áttekintése

Ez a lépés nem kötelező. Ha meg szeretné ismerni, hogyan hozza létre a kód az adatbázis erőforrásait, tekintse át a következő kódrészleteket. A kódrészletek mind a Program.cs fájlból származnak, amely a C:\git-samples\azure-cosmos-db-cassandra-dotnet-getting-started\CassandraQuickStartSample mappában található. Egyéb esetben ugorhat A kapcsolati sztring frissítése szakaszra.

  • Egy Cassandra fürtvégponthoz való csatlakozással inicializálja a munkamenetet. Az Azure Cosmos DB-n lévő Cassandra API csak a TLS 1.2-es verziót támogatja.

    var options = new Cassandra.SSLOptions(SslProtocols.Tls12, true, ValidateServerCertificate);
    options.SetHostNameResolver((ipAddress) => CassandraContactPoint);
    Cluster cluster = Cluster.Builder().WithCredentials(UserName, Password).WithPort(CassandraPort).AddContactPoint(CassandraContactPoint).WithSSL(options).Build();
    ISession session = cluster.Connect();
    
  • Új kulcsterület létrehozása.

    session.Execute("CREATE KEYSPACE uprofile WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'datacenter1' : 1 };"); 
    
  • Új tábla létrehozása.

    session.Execute("CREATE TABLE IF NOT EXISTS uprofile.user (user_id int PRIMARY KEY, user_name text, user_bcity text)");
    
  • Felhasználói entitások beszúrása az IMapper objektum használatával a uprofile kulcsterülethez csatlakozó új munkamenettel.

    mapper.Insert<User>(new User(1, "LyubovK", "Dubai"));
    
  • Összes felhasználói adat lekérdezése.

    foreach (User user in mapper.Fetch<User>("Select * from user"))
    {
       Console.WriteLine(user);
    }
    
  • Egyetlen felhasználó adatainak lekérdezése.

    mapper.FirstOrDefault<User>("Select * from user where user_id = ?", 3);
    

A kapcsolati sztring frissítése

Lépjen vissza az Azure Portalra a kapcsolati sztring adataiért, majd másolja be azokat az alkalmazásba. A kapcsolati sztring adatai lehetővé teszik az alkalmazás számára, hogy kommunikáljon az üzemeltetett adatbázissal.

  1. Az Azure Portalon válassza a Kapcsolati sztring lehetőséget.

  2. A FELHASZNÁLÓNÉV érték másolásához használja a képernyő jobb oldalán található gombot.

    Hozzáférési kulcs megtekintése és másolása az Azure Portal Kapcsolati sztring oldalán

  3. Nyissa meg a Program.cs fájlt a Visual Studióban.

  4. Illessze be a USERNAME értéket a Portalból a <FILLME> helyére a 13. sorban.

    A Program.cs 13. sorának ekkor a következőhöz hasonlónak kell kinéznie:

    private const string UserName = "cosmos-db-quickstart";

  5. Lépjen vissza a Portalba, és másolja a PASSWORD értéket. Illessze be a PASSWORD értéket a Portalból a 14. sorban található <FILLME> érték helyére.

    A Program.cs 14. sorának ekkor a következőhöz hasonlóan kell kinéznie:

    private const string Password = "2Ggkr662ifxz2Mg...==";

  6. Lépjen vissza a Portalba, és másolja a CONTACT POINT értéket. Illessze be a CONTACT POINT értéket a Portalból a 15. sorban található <FILLME> érték helyére.

    A Program.cs 15. sorának ekkor a következőhöz hasonlóan kell kinéznie:

    private const string CassandraContactPoint = "cosmos-db-quickstarts.cassandra.cosmosdb.azure.com"; // DnsName

  7. Mentse a Program.cs fájlt.

A .NET-alkalmazás futtatása

  1. A Visual Studióban válassza az Eszközök>NuGet Csomagkezelő csomagkezelő>konzolját.

  2. A parancssorban a következő paranccsal telepítse a .NET illesztő NuGet-csomagját.

    Install-Package CassandraCSharpDriver
    
  3. Az alkalmazás futtatásához nyomja le a CTRL + F5 billentyűkombinációt. Az alkalmazás megjelenik a konzolablakban.

    A kimenet megtekintése és ellenőrzése

    Nyomja le a CTRL + C billentyűkombinációt a program futásának megszakításához, és zárja be a konzolablakot.

  4. Ha megnyitja az Adatkezelőt az Azure Portalon, lekérdezheti és módosíthatja és használhatja az új adatokat.

    Adatok megtekintése az Adatkezelőben

Tekintse át az SLA-kat az Azure Portalon

A Azure Portal figyeli a Cosmos DB-fiók átviteli sebességét, tárhelyét, rendelkezésre állását, késését és konzisztenciáját. Az Azure Cosmos DB szolgáltatásiszint-szerződéshez (SLA) társított metrikák diagramjai az SLA értékét jelenítik meg a tényleges teljesítményhez képest. Ez a metrikákból álló csomag átláthatóvá teszi az SLA-k monitorozását.

Metrikák és SLA-k áttekintése:

  1. A Cosmos DB-fiók navigációs menüjében válassza a Metrikák lehetőséget.

  2. Válasszon egy lapot( például Késés), és válasszon egy időkeretet a jobb oldalon. Hasonlítsa össze a diagramok Tényleges és SLA vonalait.

    Azure Cosmos DB-metrikák

  3. Tekintse át a metrikákat a többi lapon.

Az erőforrások eltávolítása

Ha végzett az alkalmazással és az Azure Cosmos DB-fiókkal, törölheti a létrehozott Azure-erőforrásokat, így nem kell további díjakat fizetnie. Az erőforrások törlése:

  1. A Azure Portal Keresősávon keresse meg és válassza ki az erőforráscsoportokat.

  2. A listából válassza ki a rövid útmutatóhoz létrehozott erőforráscsoportot.

    Válassza ki a törölni kívánt erőforráscsoportot

  3. Az erőforráscsoport Áttekintés lapján válassza az Erőforráscsoport törlése lehetőséget.

    Az erőforráscsoport törlése

  4. A következő ablakban adja meg a törölni kívánt erőforráscsoport nevét, majd válassza a Törlés lehetőséget.

Következő lépések

Ebben a rövid útmutatóban bemutattuk, hogyan lehet Azure Cosmos DB-fiókot létrehozni, hogyan lehet az Adatkezelő segítségével tárolót készíteni, és hogyan lehet futtatni egy webalkalmazást. Most már importálhat más adatokat a Cosmos DB-fiókjába.