Rövid útmutató: Az Azure Managed Redis használata Java-ban Jedis Redis-ügyféllel

Ebben a rövid útmutatóban az Azure Managed Redist egy Java-alkalmazásba építi be a Jedis Redis-ügyféllel. 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ónozd a Java gyorsindítót a GitHubon.

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 350 GB-nál több tárterületet használó memóriabeli szintek mindegyike nyilvános előzetes verzióban érhető el, beleértve a memóriaoptimalizált M500-at és újabbakat is; Kiegyensúlyozott B500 és újabb; és Compute Optimized X500 és újabb. 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ókat 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 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 lehetőséget, majd lépjen tovább.
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.

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

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ét és portjait az Erőforrás menü Áttekintés elemének kiválasztásával kaphatja meg. 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 át az új redis-jedis-test projektkönyvtárra.
Nyissa meg a pom.xml fájlt. A fájlban a Jedis 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 az Azure Managed Redis használatával történő Microsoft Entra ID-hitelesítés ajánlott módszere.
```
<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 Managed 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 Managed Redis-példányhoz a gyorsítótár gazdagépnevének és kulcs környezeti változóinak használatával. A kód emellett egy sztring értéket tárol és lekér a gyorsítótárból. 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 egy új értékre lett frissítve jedis.set használatával. 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 Managed Redist egy Java-alkalmazásból.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-03-31