Funkce Apache Cassandra, které podporuje rozhraní API Cassandra pro Azure Cosmos DB

PLATÍ PRO: rozhraní API Cassandra

Azure Cosmos DB je globálně distribuovaná databázová služba Microsoftu pro více modelů. S klientem Azure Cosmos DB můžete rozhraní API Cassandra prostřednictvím přenosového protokolu CQL Binary Protocol v4, který vyhovuje open source klientským ovladačům Cassandra.

Když použijete rozhraní API Cassandra pro Azure Cosmos DB, získáte nejen výhody rozhraní API pro Apache Cassandra, ale i podnikové funkce, které poskytuje Azure Cosmos DB. Mezi podnikové funkce patří globální distribuce, automatické dělení škálování na více systémů, záruky dostupnosti a latence, šifrování při nečinnosti, zálohování a mnoho dalšího.

Protokol Cassandra

Azure Cosmos DB rozhraní API Cassandra je kompatibilní s rozhraním API jazyka Cassandra Query Language (CQL) v3.11 (zpětně kompatibilní s verzí 2.x). Podporované příkazy CQL, nástroje, omezení a výjimky najdete níže. Jakýkoli ovladač klienta, který podporuje tyto protokoly, by se měl dokázat připojit k rozhraní API Cassandra pro Azure Cosmos DB.

Ovladač Cassandra

Rozhraní API Cassandra pro Azure Cosmos DB podporuje tyto verze ovladačů Cassandra:

• Java 3.5+
• C# 3.5+
• NodeJS 3.5+
• Python 3.15+
• C++ 2.9
• PHP 1.3
• Gocql

Datové typy CQL

Rozhraní API Cassandra pro Azure Cosmos DB podporuje následující datové typy CQL:

Pro deklaraci datového typu je podporována statická.

Funkce CQL

Rozhraní API Cassandra pro Azure Cosmos DB podporuje tyto funkce CQL:

Agregační funkce:

Funkce pro převod objektů BLOB:

Funkce UUID a timeuuid:

Příkazy CQL

Azure Cosmos DB podporuje u účtů rozhraní API Cassandra následující databázové příkazy.

Zjednodušené transakce ( PŘIT)

Příkazy prostředí CQL

Azure Cosmos DB podporuje u účtů rozhraní API Cassandra následující databázové příkazy.

Podpora JSON

Omezení rozhraní API Cassandra

Rozhraní API Cassandra pro Azure Cosmos DB nemá žádná omezení velikosti dat uložených v tabulce. Když se dodrží limity klíče oddílu, je možné uložit stovky terabajtů nebo petabajtů dat. Podobně nemá každá entita nebo ekvivalent řádku žádné omezení počtu sloupců. Celková velikost entity by ale neměla překročit 2 MB. Data na klíč oddílu nesmí překročit 20 GB jako ve všech ostatních rozhraních API.

nástroje

Rozhraní API Cassandra pro Azure Cosmos DB je platforma pro spravované služby. Ke správě clusteru nevyžaduje žádnou režii ani nástroje řízení, jako jsou například systém uvolňování paměti, Java Virtual Machine (JVM) a nodetool. Podporuje nástroje, jako je cqlsh, které využívá kompatibilitu Binary CQLv4.

• Azure Portal správy účtu jsou průzkumník dat, metriky, diagnostika protokolů, PowerShell a rozhraní příkazového řádku.

Hostované prostředí CQL (Preview)

Hostované nativní prostředí Cassandra (CQLSH v5.0.1) můžete otevřít přímo z Průzkumník dat v Azure Portal nebo v Průzkumníku služby Azure Cosmos DB. Před povolením prostředí CQL musíte ve svém účtu povolit funkci Poznámkových bloků (pokud ještě není povolená, zobrazí se výzva při kliknutí na Open Cassandra Shell ). Viz článek Povolení poznámkových bloků pro účty Azure Cosmos DB pro podporované oblasti Azure.

Ke službě Cosmos Azure rozhraní API Cassandra DB se také můžete připojit pomocí protokolu CQLSH nainstalovaného na místním počítači. Dodává se s Apache Cassandra 3.1.1 a funguje bez dalších nastavení nastavením proměnných prostředí. Následující části obsahují pokyny k instalaci, konfiguraci a připojení k rozhraní API Cassandra ve službě Azure Cosmos DB v Windows nebo Linuxu pomocí CQLSH.

Windows:

Pokud používáte Windows, doporučujeme povolit systém souborů Windows pro Linux. Pak můžete postupovat podle následujících linuxových příkazů.

Unix/Linux/Mac:

# Install default-jre and default-jdk
sudo apt install default-jre
sudo apt-get update
sudo apt install default-jdk

# Import the Baltimore CyberTrust root certificate:
curl https://cacert.omniroot.com/bc2025.crt > bc2025.crt
keytool -importcert -alias bc2025ca -file bc2025.crt

# Install the Cassandra libraries in order to get CQLSH:
echo "deb http://www.apache.org/dist/cassandra/debian 311x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
curl https://downloads.apache.org/cassandra/KEYS | sudo apt-key add -
sudo apt-get update
sudo apt-get install cassandra

# Export the SSL variables:
export SSL_VERSION=TLSv1_2
export SSL_VALIDATE=false

# Connect to Azure Cosmos DB API for Cassandra:
cqlsh <YOUR_ACCOUNT_NAME>.cassandra.cosmosdb.azure.com 10350 -u <YOUR_ACCOUNT_NAME> -p <YOUR_ACCOUNT_PASSWORD> --ssl

Všechny operace CRUD prováděné prostřednictvím sady SDK kompatibilní s CQL v4 vrátí další informace o spotřebovaných jednotkách chyb a žádostí. Příkazy DELETE a UPDATE by se měly zpracovat s ohledem na zásady správného řízení prostředků, aby se zajistilo co nejefektivnější využití zřízené propustnosti.

• Poznámka: Pokud je zadaná hodnota gc_grace_seconds, musí být nulová.

var tableInsertStatement = table.Insert(sampleEntity); 
var insertResult = await tableInsertStatement.ExecuteAsync(); 
 
foreach (string key in insertResult.Info.IncomingPayload) 
        { 
            byte[] valueInBytes = customPayload[key]; 
            double value = Encoding.UTF8.GetString(valueInBytes); 
            Console.WriteLine($"CustomPayload:  {key}: {value}"); 
        } 

Mapování konzistence

Rozhraní API Cassandra pro Azure Cosmos DB poskytuje volbu konzistence pro operace čtení. Mapování konzistence je podrobně popisné tady.

Správa oprávnění a rolí

Azure Cosmos DB podporuje řízení přístupu na základě role v Azure (Azure RBAC) pro zřizování, obměny klíčů, zobrazování metrik a hesel/klíčů pro čtení a zápis a jen pro čtení, které je možné získat prostřednictvím Azure Portal. Azure Cosmos DB nepodporuje role pro aktivity CRUD.

Možnosti prostoru klíčů a tabulky

Možnosti pro název oblasti, třídu, replication_factor a datacentrum v příkazu Vytvořit prostor klíčů se v současné době ignorují. Systém k přidání oblastí používá základní metodu globální replikace služby Azure Cosmos DB. Pokud potřebujete data napříč oblastmi, můžete je povolit na úrovni účtu pomocí PowerShellu, rozhraní příkazového řádku nebo portálu. Další informace najdete v článku o přidávání oblastí. Durable_writes není možné zakázat, protože Azure Cosmos DB zajišťuje odolnost každého zápisu. V každé oblasti Azure Cosmos DB replikuje data do sady replik, která se schová ze čtyř replik, a tuto konfiguraci sady replik není možné upravit.

Všechny možnosti jsou při vytváření tabulky ignorovány s výjimkou gc_grace_seconds, které by měly být nastaveny na nulu. Prostor klíčů a tabulka mají další možnost s názvem "cosmosdb_provisioned_throughput" s minimální hodnotou 400 RU/s. Propustnost prostoru klíčů umožňuje sdílení propustnosti mezi více tabulkami a je užitečná ve scénářích, kdy všechny tabulky nevyužívané zřízenou propustnost. Příkaz Alter Table umožňuje změnit zřízenou propustnost napříč oblastmi.

CREATE  KEYSPACE  sampleks WITH REPLICATION = {  'class' : 'SimpleStrategy'}   AND cosmosdb_provisioned_throughput=2000;  

CREATE TABLE sampleks.t1(user_id int PRIMARY KEY, lastname text) WITH cosmosdb_provisioned_throughput=2000; 

ALTER TABLE gks1.t1 WITH cosmosdb_provisioned_throughput=10000 ;

Sekundární index

rozhraní API Cassandra podporuje sekundární indexy u všech datových typů s výjimkou zamrzlých typů kolekcí a typů desetinných míst a variant.

Používání zásad opakování připojení Cassandra

Azure Cosmos DB je systém řízený prostředky. To znamená, že v dané sekundě můžete provádět určitý počet operací na základě jednotek žádostí spotřebovaných operacemi. Pokud aplikace tento limit překročí v dané sekundě, požadavky budou rychlostně omezené a budou vyvolány výjimky. Aplikace rozhraní API Cassandra Azure Cosmos DB překládá tyto výjimky na přetížené chyby v nativním protokolu Cassandra. Aby se zajistilo, že vaše aplikace může zachycovat a opakovat požadavky v případě omezení rychlosti, jsou k dispozici rozšíření Sparku a Javy. Pokud se připojujete ke službě Azure rozhraní API Cassandra ve službě Azure Cosmos DB, podívejte se také na ukázky kódu Java pro ovladače Datastax verze 3 a 4. Pokud používáte jiné sady SDK pro přístup k rozhraní API Cassandra ve službě Azure Cosmos DB, vytvořte zásadu připojení, která bude pokus opakovat u těchto výjimek.

Další kroky

• Začínáme s vytvořením účtu rozhraní API Cassandra, databáze a tabulky prostřednictvím aplikace Java