Rövid útmutató: Az Azure Cache for Redis használata Javában a Jedis Redis-ügyféllel

A következőre érvényes:: ✅ Azure Cache for Redis, ✅ Azure Managed Redis

Ebben a rövid útmutatóban az Azure Cache for Redist egy Java-alkalmazásba építi be a Jedis Redis-ügyfél használatával. A gyorsítótár egy biztonságos, dedikált gyorsítótár, amely az Azure bármely alkalmazásából elérhető.

Klónozza a GitHubon a Java adattár rövid útmutatót .

Előfeltételek

Azure-előfizetés – hozzon létre egyet ingyenesen
Apache Maven

Azure Managed Redis-példány létrehozása

Azure Managed Redis-példány létrehozásához jelentkezzen be az Azure Portalra, és válassza az Erőforrás létrehozása lehetőséget.
Az Erőforrás létrehozása lapon írja be az Azure Managed Redis kifejezést a keresőmezőbe.
Válassza az Azure Managed Redis csempét, és válassza a Létrehozás lehetőséget.

Az Azure Managed Redis-példány létrehozása panelen konfigurálja egy új gyorsítótár beállításait az Alapszintű beállítások lapon.

Beállítás	Válasszon egy értéket	Leírás
Előfizetés	Legördülő menüben válassza ki az előfizetését.	Az előfizetés, amely alatt létre kell hozni ezt az új Azure Managed Redis-példányt.
Erőforráscsoport	Legördülő menüben jelöljön ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, és adjon meg egy új erőforráscsoportnevet.	Annak az erőforráscsoportnak a neve, amelyben létre kívánja hozni a gyorsítótárat és más erőforrásokat. Ha az összes alkalmazás-erőforrást egy erőforráscsoportba helyezi, egyszerűen kezelheti vagy törölheti őket.
Név	Adjon meg egy egyedi nevet a régióban.	A gyorsítótár nevének 1 és 63 karakter közötti karakterláncnak kell lennie, ha a gyorsítótár csak számokat, betűket vagy kötőjeleket tartalmazó régiónevével van kombinálva. (Ha a gyorsítótár neve kevesebb, mint 45 karakter hosszú, akkor az összes jelenleg elérhető régióban működnie kell.) A névnek számmal vagy betűvel kell kezdődnie és végződnie, és nem tartalmazhat egymást követő kötőjeleket. A gyorsítótárpéldány gazdagépneve`\<DNS name\>.\<Azure region\>.redis.azure.net`.
Régió	Legördülő menüben válasszon ki egy helyet.	Az Azure Managed Redis a kiválasztott Azure-régiókban érhető el.
Adatszint	Válassza ki a memóriában a nagy teljesítményű, vagy a Flash lehetőséget az alacsonyabb teljesítményű gyorsítótárakhoz	A memóriabeli szintek közé tartozik a Kiegyensúlyozott, a Memóriaoptimalizált és a Számításoptimalizált. Használja a Flash-szintet a memóriában (RAM) és a lemezen (SSD) tárolt adatok tárolására.
Gyorsítótár mérete	Legördülő menüben válasszon ki egy méretet.	A gyorsítótár mérete a szinttől függ. A legkisebb méret egy kiegyensúlyozott szint. A legnagyobb memóriában tárolt szint egy memóriaoptimalizált szint.
teljesítmény	Legördülő menüben válasszon egy teljesítménybeállítást.	A teljesítmény a vCPU-k számától függ. A vCPU száma a szinttől függően változik. A Compute Optimized rendelkezik a legtöbb vCPU-val.

A megfelelő teljesítményszint kiválasztásával kapcsolatos útmutatásért lásd : A megfelelő szint kiválasztása.

Fontos

A több mint 235 GB tárhelyet használó memóriabeli szintek nyilvános előzetes verzióban érhetők el, beleértve a memóriaoptimalizált M350-et és az annál magasabb szinteket; Kiegyensúlyozott B350-et és az annál újabbakat; valamint a számítási teljesítményre optimalizált X350-et és az annál újabb verziókat. Ezek a szintek és magasabb szintek nyilvános előzetes verzióban érhetők el.

Minden Flash-optimalizált szint nyilvános előzetes verzióban érhető el.

Válassza a Tovább: Hálózatkezelés lehetőséget, és válassza a nyilvános hozzáférés letiltása és a privát hozzáférés használata vagy a nyilvános hozzáférés engedélyezése az összes hálózatból.
Válassza a Tovább: Aktív georeplikáció lehetőséget. Az aktív georeplikálás használatához engedélyezni kell a kiépítés során. Az aktív georeplikációs funkcióval nem rendelkező gyorsítótárak később nem vehetők fel aktív georeplikációs csoportokhoz, és nem csatlakozhatnak hozzájuk. További információ: Aktív georeplikálás konfigurálása Azure Managed Redis-példányokhoz.
Válassza a Tovább: Speciális fület.

Konfigurálja a példányhoz hozzáadni kívánt Redis-modulokat .

Fürtkezelési szabályzat beállítása:
- Az Enterprise használata a RedisSearch vagy más modulok használatához
- OsS használata fürtözött gyorsítótárhoz.
- Nem fürtözött (előzetes verzió) használata nem fürtözött gyorsítótárhoz.
A fürtszabályzat kiválasztásáról további információt a Fürtszabályzat című témakörben talál.

Alapértelmezés szerint egy új felügyelt gyorsítótár esetében:
- A Microsoft Entra-azonosító engedélyezve van.
- A hozzáférési kulcsok hitelesítése biztonsági okokból le van tiltva.
Fontos

A gyorsítótárpéldány létrehozása után nem módosíthatja a modulokat. A modulokat engedélyezni kell az Azure Managed Redis-példány létrehozásakor. A gyorsítótár létrehozása után nincs lehetőség a modul konfigurálásának engedélyezésére.

Fontos

Az optimális biztonság érdekében azt javasoljuk, hogy a Microsoft Entra ID-t felügyelt identitásokkal használva engedélyezze a kéréseket a gyorsítótáron, ha lehetséges. A Microsoft Entra-azonosító és a felügyelt identitások használatával történő engedélyezés kiváló biztonságot és egyszerű használatot biztosít a megosztott hozzáférési kulcsok engedélyezésével szemben. A felügyelt identitások gyorsítótárral való használatáról további információt a Microsoft Entra ID használata gyorsítótár-hitelesítéshez című témakörben talál.

Fontos

A létrehozás után nem módosíthatja egy Azure Managed Redis-példány fürtözési szabályzatát. RediSearch használata esetén a vállalati fürtszabályzat szükséges, és NoEviction ez az egyetlen támogatott kiürítési szabályzat.

Fontos

Ha ezt a gyorsítótárpéldányt georeplikációs csoportban használja, a kizárási házirendek nem módosíthatók a példány létrehozása után. A gyorsítótár létrehozása előtt mindenképpen ismernie kell az elsődleges csomópontok kiürítési szabályzatait. Az aktív georeplikációs adatokról további információt az Aktív georeplikációs előfeltételek című témakörben talál.
Válassza a Következő: Címkék és kihagyás lehetőséget.
Válassza a Tovább: Áttekintés és létrehozás lehetőséget.
Tekintse át a beállításokat, és válassza a Létrehozás lehetőséget.

A Redis-példány létrehozása több percet vesz igénybe. Az előrehaladást az Azure Managed Redis áttekintési oldalán követheti nyomon. Ha az állapot „Fut” állapotként jelenik meg, a gyorsítótár készen áll a használatra.

Azure Cache for Redis-példány létrehozása

Az Azure Portalon keresse meg és válassza ki az Azure Cache for Redist.
Az Azure Cache for Redis lapon válassza azAzure Cache for Redis>.
Az Új Redis Cache lap Alapjai lapján konfigurálja a következő beállításokat:
- Előfizetés: Válassza ki a használni kívánt előfizetést.
- Erőforráscsoport: Válasszon ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, és adjon meg egy új erőforráscsoportnevet. Ha az összes alkalmazás-erőforrást ugyanabba az erőforráscsoportba helyezi, egyszerűen kezelheti vagy törölheti őket.
- Név: Adjon meg egy, a régióban egyedi gyorsítótárnevet. A névnek a következőnek kell lennie:
  - Legyen 1–63 karakterből álló karakterlánc.
  - Csak számokat, betűket és kötőjeleket tartalmaz.
  - Kezdés és befejezés számmal vagy betűvel.
  - Nem tartalmaz egymást követő kötőjeleket.
- Régió: Válasszon ki egy Azure-régiót a gyorsítótárat használó más szolgáltatások közelében.
- Gyorsítótár termékváltozata: Válasszon ki egy termékváltozatot a gyorsítótár rendelkezésre álló méreteinek, teljesítményének és funkcióinak meghatározásához.
- Gyorsítótár mérete: Válasszon egy gyorsítótárméretet. További információ: Azure Cache for Redis – áttekintés.
Válassza a Hálózatkezelés lapot, vagy válassza a Tovább: Hálózatkezelés lehetőséget.
A Hálózatkezelés lapon válassza ki a gyorsítótárhoz használni kívánt kapcsolati módszert. A privát végpont használata ajánlott a biztonság érdekében. Ha a Privát végpont lehetőséget választja, válassza a Privát végpont hozzáadása lehetőséget, és hozza létre a privát végpontot.
Válassza a Speciális lapot, vagy válassza a Tovább: Speciális lehetőséget.
A Speciális panelen konfigurálja a következő beállításokat:
- Válassza a Microsoft Entra-hitelesítés vagy a hozzáférési kulcsok hitelesítése lehetőséget. A Microsoft Entra-hitelesítés alapértelmezés szerint engedélyezve van.
- Adja meg, hogy engedélyezi-e a nem TLS-portot.
- Prémium szintű gyorsítótár esetén konfigurálhatja vagy letilthatja a rendelkezésre állási zónákat. A gyorsítótár létrehozása után nem tilthatja le a rendelkezésre állási zónákat. Standard gyorsítótár esetén a rendelkezésre állási zónák automatikusan lesznek lefoglalva. A rendelkezésre állási zónák nem érhetők el az alapszintű termékváltozathoz.
- Prémium szintű gyorsítótár esetén konfigurálja a replikák számának, a fürtözés és a szegmensek számának, a rendszer által hozzárendelt felügyelt identitásnak és az adatmegőrzésnek a beállításait.
Az alábbi képen a Standard termékváltozat Speciális lapja látható.

Fontos

Ha lehetséges, a Microsoft Entra ID és a felügyelt identitások használatával engedélyezheti a kéréseket a gyorsítótáron. A Microsoft Entra-azonosítót és felügyelt identitást használó engedélyezés nagyobb biztonságot nyújt, és könnyebben használható, mint a közös hozzáférési kulcs engedélyezése. A felügyelt identitások gyorsítótárral való használatáról további információt a Microsoft Entra ID használata gyorsítótár-hitelesítéshez című témakörben talál.
Ha szeretné, válassza a Címkék lapot, vagy válassza a Tovább: Címkék lehetőséget, és adja meg a címkék nevét és értékeit a gyorsítótár-erőforrások kategorizálásához.
Válassza a Véleményezés + létrehozás lehetőséget, és ha az ellenőrzés sikeres, válassza a Létrehozás lehetőséget.

Az új gyorsítótár üzembe helyezése több percet vesz igénybe. Az üzembe helyezés előrehaladását az Azure Cache for Redis portál oldalán követheti nyomon. Amikor a gyorsítótár működési állapotaműködésben van, a gyorsítótár készen áll a használatra.

Állomásnév, portok és hozzáférési kulcsok lekérése az Azure Portalról

Az Azure Cache for Redis-kiszolgáló csatlakoztatásához a gyorsítótár-ügyfélnek szüksége van a gazdagép nevére, portjára és kulcsára a gyorsítótárhoz. Egyes ügyfelek különböző neveken hivatkozhatnak ezekre az elemekre. A gazdagép nevét, portját és kulcsait az Azure Portalról szerezheti be.

A gyorsítótár gazdagépnevének és portjának lekéréséhez válassza az Erőforrás menü Áttekintés elemét. A gazdagép neve az <DNS name>.redis.cache.windows.net formátumú.
A hozzáférési kulcsok lekéréséhez válassza az Erőforrás menü Hitelesítés elemét. Ezután válassza az Access-kulcsok lapot.

A munkakörnyezet beállítása

Az alábbi lépések bemutatják, hogyan állíthatja be a Munkakörnyezetet a Java-alkalmazáshoz.

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export REDIS_CACHE_PORT=10000

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export REDIS_CACHE_PORT=6380

Helyettesítse a helyőrzőket a következő értékekkel:

<your-host-name>: A DNS-állomás neve. A gyorsítótár gazdagépnevének és portjának lekéréséhez válassza az Erőforrás menü Áttekintés elemét. A gazdagép neve az <DNS name>.redis.cache.windows.net formátumú.
<your-client-id>: Az Azure AD-alkalmazásregisztráció alkalmazás-(ügyfél-) azonosítója.
<your-client-secret>: Az Azure AD-alkalmazásregisztráció ügyfélkódja.
<your-tenant-id>: Az Azure Active Directory bérlői azonosítója.

Megjegyzés:

A fenti példa ügyfél titkos hitelesítést használ. A redis-authx-entraid kódtárat úgy is konfigurálhatja, hogy más hitelesítési módszereket, például felügyelt identitást vagy ügyféltanúsítványt használjon azzal, hogy módosítja a kódjában lévő EntraIDTokenAuthConfigBuilder konfigurációt.

Új Java-alkalmazás létrehozása

Új gyorsútmutató-alkalmazás létrehozása a Maven használatával:

mvn archetype:generate \
    -DarchetypeGroupId=org.apache.maven.archetypes \
    -DarchetypeArtifactId=maven-archetype-quickstart \
    -DarchetypeVersion=1.3 \
    -DinteractiveMode=false \
    -DgroupId=example.demo \
    -DartifactId=redis-jedis-test \
    -Dversion=1.0

Váltson az új redis-jedis-test projektkönyvtárra.
Nyissa meg a pom.xml fájlt. A fájlban a Jedik függősége látható:

Megjegyzés:

A Microsoft partnerséget kötött a Redis, Inc. Az együttműködés részeként a Microsoft Entra ID hitelesítési támogatása átkerült az Azure SDK-ból a Redis Entra ID-bővítményekbe. Az új redis-authx-entraid kódtár továbbfejlesztett hitelesítési képességeket biztosít, és a Microsoft Entra ID-hitelesítés ajánlott módszere az Azure Cache for Redis használatával.
```
<dependency>
    <groupId>redis.clients.authentication</groupId>
    <artifactId>redis-authx-entraid</artifactId>
    <version>0.1.1-beta2</version>
</dependency>

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>6.0.0</version> 
</dependency>
```
Zárja be a pom.xml fájlt.

Nyissa meg App.java , és tekintse meg a következő kóddal rendelkező kódot:

package example.demo;

import com.azure.identity.DefaultAzureCredentialBuilder;
import redis.clients.authentication.core.TokenAuthConfig;
import redis.clients.authentication.entraid.AzureTokenAuthConfigBuilder;
import redis.clients.jedis.DefaultJedisClientConfig;
import redis.clients.jedis.HostAndPort;
import redis.clients.jedis.UnifiedJedis;
import redis.clients.jedis.authentication.AuthXManager;

import java.util.Set;

/**
* Redis test with Microsoft Entra ID authentication using redis-authx-entraid
* For more information about Redis authentication extensions, see:
* https://redis.io/docs/latest/develop/clients/jedis/amr/
*
*/
public class App
{
    public static void main( String[] args )
    {
        String REDIS_CACHE_HOSTNAME = System.getenv("REDIS_CACHE_HOSTNAME");
        int REDIS_PORT = Integer.parseInt(System.getenv().getOrDefault("REDIS_CACHE_PORT", "10000"));
        String SCOPES = "https://redis.azure.com/.default"; // The scope for Azure Cache for Redis

        // Build TokenAuthConfig for Microsoft Entra ID authentication
        TokenAuthConfig tokenAuthConfig = AzureTokenAuthConfigBuilder.builder()
                .defaultAzureCredential(new DefaultAzureCredentialBuilder().build())
                .scopes(Set.of(SCOPES))
                .tokenRequestExecTimeoutInMs(2000)
                .build();

        DefaultJedisClientConfig config = DefaultJedisClientConfig.builder()
                .authXManager(new AuthXManager(tokenAuthConfig))
                .ssl(true)
                .build();

        UnifiedJedis jedis = new UnifiedJedis(
                new HostAndPort(REDIS_CACHE_HOSTNAME, REDIS_PORT),
                config);

        // Test the connection
        System.out.println(String.format("Database size is %d", jedis.dbSize()));

        // Simple PING command
        System.out.println( "\nCache Command  : Ping" );
        System.out.println( "Cache Response : " + jedis.ping());

        // Simple get and put of integral data types into the cache
        System.out.println( "\nCache Command  : GET Message" );
        System.out.println( "Cache Response : " + jedis.get("Message"));

        System.out.println( "\nCache Command  : SET Message" );
        System.out.println( "Cache Response : " + jedis.set("Message", "Hello! The cache is working from Java!"));

        // Demonstrate "SET Message" executed as expected...
        System.out.println( "\nCache Command  : GET Message" );
        System.out.println( "Cache Response : " + jedis.get("Message"));

        jedis.close();
    }
}

Ez a kód bemutatja, hogyan csatlakozhat egy Azure Cache for Redis-példányhoz a gyorsítótár-gazdagép neve és a kulcsfontosságú környezeti változók használatával. A kód emellett tárolja és lekéri gyorsítótár egyik sztringértékét. A PING parancsok is végrehajtásra kerülnek.

Zárja be a App.java fájlt.

Az alkalmazás létrehozása és futtatása

Hajtsa végre a következő Maven-parancsot az alkalmazás buildeléséhez és elindításához:

mvn compile exec:java -D exec.mainClass=example.demo.App

Az alábbi kimenetben láthatja, hogy a Message kulcs korábban gyorsítótárazott értékkel rendelkezett. Az érték új értékre lett frissítve a következő használatával jedis.set: . Az alkalmazás a parancsokat is végrehajtotta PING .

Cache Command  : Ping
Cache Response : PONG

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java!

Cache Command  : SET Message
Cache Response : OK

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java!

Erőforrások tisztítása

Ha folytatni szeretné a következő oktatóanyagot, megtarthatja az ebben a rövid útmutatóban létrehozott erőforrásokat, és újra felhasználhatja őket.

Ellenkező esetben, ha végzett a gyorsútmutató-mintaalkalmazással, törölheti az ebben a rövid útmutatóban létrehozott Azure-erőforrásokat a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem visszaállítható; az erőforráscsoport és a benne foglalt erőforrások véglegesen törlődnek. Figyeljen arra, hogy ne töröljön véletlenül erőforráscsoportot vagy erőforrásokat. Ha a minta üzemeltetéséhez létrehozott erőforrásokat egy meglévő erőforráscsoporton belül hozta létre, amely a megtartani kívánt erőforrásokat tartalmazza, az erőforráscsoport törlése helyett egyenként törölheti az egyes erőforrásokat.

Jelentkezzen be az Azure Portalra, és válassza az Erőforráscsoportok elemet.
A Szűrő név szerint szövegmezőbe írja be az erőforráscsoport nevét. A cikk utasításai egy erőforráscsoportot TestResourceshasználtak. Az eredménylistában az erőforráscsoportban válassza az Erőforrások tesztelése, majd az Erőforráscsoport törlése lehetőséget.
Írja be az erőforráscsoport nevét a törlés megerősítéséhez, majd válassza a Törlés lehetőséget.

A rendszer néhány pillanaton belül törli az erőforráscsoportot és a benne foglalt erőforrásokat.

Következő lépések

Ebben a rövid útmutatóban megtanulta, hogyan használhatja az Azure Cache for Redist Egy Java-alkalmazásból. Folytassa a következő rövid útmutatóval az Azure Cache for Redis ASP.NET webalkalmazással való használatához.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-11-26