redis-cli, Redis ile birlikte gelen komut satırı aracıdır. Bu aracı, bir Elastic Compute Service (ECS) örneğinden veya yerel bir cihazdan ApsaraDB for Redis ve Tair örneklerine bağlanmak ve bu örnekleri yönetmek için kullanın.
Önkoşullar
Başlamadan önce aşağıdakileri yaptığınızdan emin olun:
Örnek hesabı için parolayı ayarlayın. Varsayılan hesap parolasını kullanabilir veya kendi parolasına sahip bir standart hesap oluşturabilirsiniz. Parolayı değiştirmek veya sıfırlamak için bkz. Parolayı değiştirme veya sıfırlama.
Cihazınızın IP adresini örnek IP izin listesine ekleyin. Bkz. IP izin listelerini ayarlama.
Örnek uç noktasını edinin. Bkz. Uç noktaları görüntüleme.
Hangi uç nokta ve IP adresinin kullanılacağı:
| Cihaz | Ağ | İzin listesine eklenecek IP | Kullanılacak uç nokta |
|---|---|---|---|
| Örnek ile aynı sanal özel cloud (VPC) içindeki ECS örneği | VPC (önerilir) | ECS örneğinin özel IP adresi | VPC uç noktası |
| Farklı bir VPC'deki (örneğin farklı bir bölgedeki) ECS örneği | İnternet | ECS örneğinin genel IP adresi | Genel uç nokta |
| Yerel cihaz | İnternet | Cihazın genel IP adresi | Genel uç nokta |
Varsayılan olarak örneklerin yalnızca bir VPC uç noktası vardır. İnternet üzerinden bağlanmak için öncelikle genel uç nokta başvurusu yapın.
redis-cli yükleme
redis-cli, Redis paketinin bir parçası olarak yüklenir. redis-cli sürümünün örnek sürümünüzle eşleşmesi gerekmez.
Bir örneğe bağlanma
-
redis-cli kurulu olduğu dizine gidin.
Linux
Redis kaynak klasöründeki
srcdizinine gidin. Örneğin,cd /home/redis-7.2.0/srckomutunu çalıştırın.macOS
Homebrew bin dizinine gidin. Örneğin,
cd /opt/homebrew/binkomutunu çalıştırın.Windows
Komut satırı penceresini açın ve redis-cli konumuna gidin.
-
Bağlantı komutunuzu seçin
Komutu çalıştırmadan önce iki şeyi doğrulayın:
Örnek mimariniz — standart veya küme. Konsoldaki örnek ayrıntıları sayfasını kontrol edin.
Bağlantı türünüz — VPC uç noktası veya genel uç nokta. Hangi ana bilgisayar adının kullanılacağını belirler.
Kurulumunuzla eşleşen komutu seçin:
Senaryo Komut Standart mimari veya proxy uç noktası üzerinden küme mimarisi ./redis-cli -h <hostname> -p <port>Doğrudan bağlantı adresi üzerinden küme mimarisi ./redis-cli -h <hostname> -p <port> -cWindows PowerShell'de
./redis-cliifadesini.\redis-cliile değiştirin.Parametreler:
Parametre Açıklama Nasıl alınır <hostname>Örnek uç noktası Konsoldan VPC uç noktasını veya genel uç noktasını alın. Bkz. Uç noktaları görüntüleme. <port>Örnek bağlantı noktası Varsayılan değer 6379şeklindedir. Özel bir bağlantı noktası için bkz. Uç noktasını veya bağlantı noktasını değiştirme.-cKüme modunu etkinleştir Yalnızca küme mimarisine sahip örneklerde ve doğrudan bağlantı adresi kullanılırken gereklidir. Örnek:
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -
Kimlik doğrulaması yapın
Bağlandıktan sonra
AUTHkomutunu çalıştırın:AUTH <password>Parola formatı hesap türünüze bağlıdır:
Hesap türü Parola formatı Örnek Varsayılan hesap (adı defaultveya örnek kimliği)Yalnızca parola AUTH Rp829dlwaStandart hesap user:passwordAUTH testaccount:Rp829dlwaVPC üzerinden parolasız erişim etkinleştirilmişse kimlik doğrulama adımını atlayın ve komutları doğrudan çalıştırın.
-
Bağlantıyı doğrulayın
AUTHkomutundanOKyanıtı almanız bağlantının başarılı olduğunu gösterir. Okuma ve yazma erişimini doğrulamak için hızlı bir test çalıştırın:set testkey "hello" # Write a test value OK get testkey # Read it back "hello" set tempkey "bye" EX 5 # Write with a 5-second expiration get tempkey "bye" # Wait 5 seconds get tempkey (nil) # Key has expiredDesteklenen komutların listesi için bkz. Komutlara genel bakış.
Sorun giderme
Örneğinizin küçük sürümü güncel değilse hata mesajları aşağıdakilerden farklı olabilir. En son hata mesajlarını almak için küçük sürümü güncelleyin.
| Hata | Neden ve çözüm |
|---|---|
(error) ERR illegal address |
Bağlanan IP adresi izin listesinde yok. Önkoşullarda açıklandığı gibi adresi ekleyin. |
(error) ERR client ip is not in whitelist |
|
(error) ERR invalid password |
Parola veya format yanlış. Standart bir hesap için user:password formatını kullanın. Parolanızı unuttuysanız parolayı sıfırlayın. |
(error) WRONGPASS invalid username-password pair |
Yukarıdakiyle aynı. |
RDM gibi üçüncü taraf araçlar kullanırken parola alanına user:password formatında parola girin.
İlgili konular
Komutlara genel bakış — desteklenen Redis komutlarına göz atın.
Hesap oluşturma ve yönetme — örnek hesaplarını ve izinlerini yönetin.