# MIGRATE **MIGRATE host port key destination-db timeout [COPY] [REPLACE]** 將 `key` 原子性地從當前實例傳送到目標實例的指定數據庫上，一旦傳送成功， `key` 保證會出現在目標實例上，而當前實例上的 `key` 會被刪除。 這個命令是一個原子操作，它在執行的時候會阻塞進行遷移的兩個實例，直到以下任意結果發生：遷移成功，遷移失敗，等到超時。 命令的內部實現是這樣的：它在當前實例對給定 `key` 執行 [_DUMP_](dump.html) 命令 ，將它序列化，然后傳送到目標實例，目標實例再使用 [_RESTORE_](restore.html) 對數據進行反序列化，并將反序列化所得的數據添加到數據庫中；當前實例就像目標實例的客戶端那樣，只要看到 [_RESTORE_](restore.html) 命令返回 `OK` ，它就會調用 [_DEL_](del.html) 刪除自己數據庫上的 `key` 。 `timeout` 參數以毫秒為格式，指定當前實例和目標實例進行溝通的**最大間隔時間**。這說明操作并不一定要在 `timeout` 毫秒內完成，只是說數據傳送的時間不能超過這個 `timeout` 數。 [MIGRATE](#migrate) 命令需要在給定的時間規定內完成 IO 操作。如果在傳送數據時發生 IO 錯誤，或者達到了超時時間，那么命令會停止執行，并返回一個特殊的錯誤： `IOERR` 。 當 `IOERR` 出現時，有以下兩種可能： * `key` 可能存在于兩個實例 * `key` 可能只存在于當前實例 唯一不可能發生的情況就是丟失 `key` ，因此，如果一個客戶端執行 [MIGRATE](#migrate) 命令，并且不幸遇上 `IOERR` 錯誤，那么這個客戶端唯一要做的就是檢查自己數據庫上的 `key` 是否已經被正確地刪除。 如果有其他錯誤發生，那么 [MIGRATE](#migrate) 保證 `key` 只會出現在當前實例中。（當然，目標實例的給定數據庫上可能有和 `key` 同名的鍵，不過這和 [MIGRATE](#migrate) 命令沒有關系）。 **可選項：** * `COPY` ：不移除源實例上的 `key` 。 * `REPLACE` ：替換目標實例上已存在的 `key` 。 **可用版本：** >= 2.6.0 **時間復雜度：** 這個命令在源實例上實際執行 [_DUMP_](dump.html) 命令和 [_DEL_](del.html) 命令，在目標實例執行 [_RESTORE_](restore.html) 命令，查看以上命令的文檔可以看到詳細的復雜度說明。`key` 數據在兩個實例之間傳輸的復雜度為 O(N) 。 **返回值：** 遷移成功時返回 `OK` ，否則返回相應的錯誤。 ## 示例 先啟動兩個 Redis 實例，一個使用默認的 6379 端口，一個使用 7777 端口。 ``` $ ./redis-server & [1] 3557 ... $ ./redis-server --port 7777 & [2] 3560 ... ``` 然后用客戶端連上 6379 端口的實例，設置一個鍵，然后將它遷移到 7777 端口的實例上： ``` $ ./redis-cli redis 127.0.0.1:6379> flushdb OK redis 127.0.0.1:6379> SET greeting "Hello from 6379 instance" OK redis 127.0.0.1:6379> MIGRATE 127.0.0.1 7777 greeting 0 1000 OK redis 127.0.0.1:6379> EXISTS greeting # 遷移成功后 key 被刪除 (integer) 0 ``` 使用另一個客戶端，查看 7777 端口上的實例： ``` $ ./redis-cli -p 7777 redis 127.0.0.1:7777> GET greeting "Hello from 6379 instance" ```