Kanál změn v rozhraní API služby Azure Cosmos DB pro Cassandra

PLATÍ PRO: rozhraní API Cassandra

Podpora kanálu změn v rozhraní API služby Azure Cosmos DB pro Cassandra je dostupná prostřednictvím predikátů dotazů v jazyce CQL (Cassandra Query Language). Pomocí těchto podmínek predikátu můžete dotazovat rozhraní API kanálu změn. Aplikace mohou získat změny provedené v tabulce pomocí primárního klíče (označované také jako klíč oddílu), jak je vyžadováno v jazyce CQL. Na základě výsledků pak můžete provádět další akce. Změny řádků v tabulce se zachycují v pořadí podle času jejich změny a pořadí řazení podle klíče oddílu.

Následující příklad ukazuje, jak získat kanál změn na všech řádcích v tabulce rozhraní API Cassandra Keyspace pomocí .NET. Predikát COSMOS_CHANGEFEED_START_TIME() se používá přímo v jazyce CQL k dotazování položek v kanálu změn ze zadaného počátečního času (v tomto případě aktuálního data a času). Úplnou ukázku pro jazyk C# si můžete stáhnout tady a pro Javu tady.

V každé iteraci dotaz pokračuje v posledních změnách bodu čtení pomocí stavu stránkování. V prostoru klíčů vidíme průběžný datový proud nových změn v tabulce. Zobrazí se změny v řádcích, které se vložily nebo aktualizovaly. Sledování operací odstranění pomocí kanálu změn v rozhraní API Cassandra se v současné době nepodporuje.

    Session cassandraSession = utils.getSession();

    try {
        DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");  
        LocalDateTime now = LocalDateTime.now().minusHours(6).minusMinutes(30);  
        String query="SELECT * FROM uprofile.user where COSMOS_CHANGEFEED_START_TIME()='" 
            + dtf.format(now)+ "'";
        
        byte[] token=null; 
        System.out.println(query); 
        while(true)
        {
            SimpleStatement st=new  SimpleStatement(query);
            st.setFetchSize(100);
            if(token!=null)
                st.setPagingStateUnsafe(token);
            
            ResultSet result=cassandraSession.execute(st) ;
            token=result.getExecutionInfo().getPagingState().toBytes();
            
            for(Row row:result)
            {
                System.out.println(row.getString("user_name"));
            }
        }
    } finally {
        utils.close();
        LOGGER.info("Please delete your table after verifying the presence of the data in portal or from CQL");
    }

Pokud chcete získat změny na jednom řádku podle primárního klíče, můžete do dotazu přidat primární klíč. Následující příklad ukazuje, jak sledovat změny pro řádek, kde "user_id = 1".

    String query="SELECT * FROM uprofile.user where user_id=1 and COSMOS_CHANGEFEED_START_TIME()='" 
                       + dtf.format(now)+ "'";
    SimpleStatement st=new  SimpleStatement(query);

Aktuální omezení

Při používání kanálu změn s rozhraní API Cassandra platí následující rozhraní API Cassandra:

  • Vložení a aktualizace se aktuálně podporují. Operace odstranění se zatím nepodporuje. Alternativním řešením je přidat do odstraněných řádků změkčnou značku. Přidejte například pole na řádek s názvem "odstraněno" a nastavte ho na "true".
  • Poslední aktualizace se zachová jako základní aktualizace SQL API a zprostředkující aktualizace entity nejsou k dispozici.

Zpracování chyb

Při použití kanálu změn v kanálu se podporují následující kódy a zprávy rozhraní API Cassandra:

  • Kód chyby HTTP 429 – Pokud je kanál změn rychlostně omezený, vrátí prázdnou stránku.

Další kroky