Redis keyspace-meldingen inschakelen (preview)

Met Redis keyspace-meldingen kunnen clients zich abonneren op pub-/subkanalen om gebeurtenissen te ontvangen die van invloed zijn op de Redis-gegevensset. Gebruik keyspacemeldingen (preview) om wijzigingen in sleutels en waarden in uw Azure beheerde Redis-cache te controleren.

In dit artikel wordt beschreven hoe u een cache implementeert waarvoor keyspacemeldingen zijn ingeschakeld, clients verbindt met behulp van Redis-opdrachten, hoe u zich abonneert op meldingskanalen en hoe u de resulterende gebeurtenissen test.

Vereiste voorwaarden

• Redis Insight of gebruikmakend van redis-cli opdrachtregelprogramma. Zie Clienthulpprogramma's gebruiken voor het beheren van gegevens in Azure Managed Redis voor installatiestappen.

  Opmerking

  Wanneer u Redis-clienthulpprogramma's gebruikt, raden wij aan om, indien beschikbaar, verificatie via Microsoft Entra ID naar Azure Managed Redis te gebruiken.

• Inzicht in ARM-sjablonen (Azure Resource Manager). Zie Azure Resource Manager documentatie voor meer informatie.

• Voor Azure CLI:

  • Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Get gestart met Azure Cloud Shell voor meer informatie.

    

  • Als u CLI-referentieopdrachten liever lokaal uitvoert, installeer de Azure CLI. Als u op Windows of macOS werkt, kunt u overwegen Azure CLI uit te voeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

    • Als u een lokale installatie gebruikt, meldt u zich aan bij de Azure CLI met behulp van de opdracht az. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Authenticate to Azure using Azure CLI voor andere aanmeldingsopties.

    • Wanneer u hierom wordt gevraagd, installeert u de Azure CLI-extensie bij het eerste gebruik. Zie Uitbreidingen gebruiken en beheren met de Azure CLI voor meer informatie over extensies.

    • Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

Een cache implementeren waarvoor keyspacemeldingen zijn ingeschakeld

In dit voorbeeld gebruikt u een arm-sjabloon (Azure Resource Manager) en de Azure CLI om een Azure Managed Redis-cache te implementeren met keyspace-meldingen ingeschakeld.

Wijzig de CacheName en Region parameters in de volgende sjabloon en sla het bestand op als KeyspaceTemplate.json.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "cachename": {
            "defaultValue": "{CacheName}",
            "type": "String"
        },
        "region": {
            "defaultValue": "{Region}",
            "type": "String"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Cache/redisEnterprise",
            "apiVersion": "2026-02-01-preview",
            "name": "[parameters('cachename')]",
            "location": "[parameters('region')]",
            "sku": {
                "name": "Balanced_B5"
            },
            "identity": {
                "type": "None"
            },
            "properties": {
                "minimumTlsVersion": "1.2",
                "publicNetworkAccess": "Enabled"
            }
        },
        {
            "type": "Microsoft.Cache/redisEnterprise/databases",
            "apiVersion": "2026-02-01-preview",
            "name": "[concat(parameters('cachename'), '/default')]",
            "dependsOn": [
                "[resourceId('Microsoft.Cache/redisEnterprise', parameters('cachename'))]"
            ],
            "properties": {
                "clientProtocol": "Encrypted",
                "port": 10000,
                "clusteringPolicy": "OSSCluster",
                "evictionPolicy": "NoEviction",
                "persistence": {
                    "aofEnabled": false,
                    "rdbEnabled": false
                },
                "notifyKeyspaceEvents": "KEA"
            }
        }
    ]
}

Implementeer de sjabloon met behulp van de opdracht az deployment group create Azure CLI. In het volgende voorbeeld bevindt de implementatie zich in de resourcegroep exampleRG .

az deployment group create --resource-group exampleRG --template-file KeyspaceTemplate.json

Redis-clients verbinden

Open twee CLI-sessies met Redis Insight of redis-cliverbind beide clients met de cache.

Gebruik één terminal als abonnee die keyspace-meldingen ontvangt en de andere als de operator die Redis-opdrachten uitvoert.

Controleren en abonneren op gebeurtenissen

Controleer in beide terminal of de meldingsreeks is geconfigureerd.

CONFIG GET notify-keyspace-events

Kies in de abonneeterminal het abonnementspatroon dat overeenkomt met de gebeurtenissen die u wilt observeren. Hier volgen enkele voorbeelden:

• Abonneer u op alle gebeurtenissen en alle sleutels:

  PSUBSCRIBE __keyevent@0__:* __keyspace@0__:*
  

• Abonneren op een specifiek gebeurtenistype:

  SUBSCRIBE __keyevent@0__:set
  

• Abonneren op een specifieke sleutel:

  SUBSCRIBE __keyspace@0__:mykey
  

Testmeldingen

Schakel over naar de operatorterminal en voer enkele Redis-opdrachten uit op een testsleutel.

SET mykey "hello"
EXPIRE mykey 10
DEL mykey

In de abonneeterminal ziet u welke gebeurtenissen zijn opgetreden en welke sleutels zijn beïnvloed.

In de volgende schermopname bevindt de abonneeterminal zich aan de linkerkant, geabonneerd op alle gebeurtenissen en alle sleutels, zodat er meldingen worden ontvangen voor alle gebeurtenissen die zich in de cache voordoen. De operatorterminal bevindt zich aan de rechterkant, waarbij Redis-opdrachten worden uitgegeven op basis van verschillende sleutels.

Instellingen voor meldingen bijwerken

U kunt de configuratie van keyspace-meldingen later wijzigen zonder de cache opnieuw te maken.

1. Werk de notifyKeyspaceEvents waarde bij KeyspaceTemplate.json bij terwijl CacheName behouden blijft en Region hetzelfde blijft.
2. Implementeer de sjabloon opnieuw.

az deployment group create --resource-group exampleRG --template-file KeyspaceTemplate.json

Door de meldingsinstellingen opnieuw te implementeren, worden deze bijgewerkt zonder gegevensverlies, zodat u gebeurtenissen kunt inschakelen, uitschakelen of wijzigen, zoals van KEA naar Ex gaan om alleen verloopgebeurtenissen bij te houden.

Verwante inhoud

• Keyspace-meldingen in Azure Cache for Redis
• Documentatie voor Redis keyspace-meldingen
• Meldingen voor Redis Keyspace-gebeurtenissen