Novice, Practiced, Mastered

    redis-dump-restore

    0.2.0 • Public • Published

    redis-dump-restore

    NPM

    NPM

    Build Status Coverage Status

    This is a library for Node.js to dump and restore Redis contents using DUMP and RESTORE commands.

    It issues those commands using the redis npm package. You have to provide instance of the client yourself. Make sure to set return_buffers and/or detect_buffers to true (see docs) so that we get Buffer instances from the client. This is required because otherwise binary data is corrupted. Use 1.0.0+ version of the redis library - previous versions have bugs in detect_buffers handling.

    Dependencies

    No production-time dependencies. For the list of test-time dependencies and their versions see the package.json file.

    Usage

    const redis = require('redis');
    const dump = require('@atlassian/redis-dump-restore').dump;
    // Use this function to DUMP all values atomically (inside MULTI)
    //const dump = require('@atlassian/redis-dump-restore').dumpMulti;
     
    const clientInstance = redis.createClient('localhost', 6379, { detect_buffers: true });
    const dumpEx = dump(clientInstance, '*');
     
    dumpEx
      .on('data', function (key, data, ttl) {
        // Do something with data.
        // Both key and data are Buffers with binary data.
        // ttl is 0 if key expiration is not set, otherwise it is a positive value in milliseconds.
      })
      .on('error', function (err) {
        // Handle error
       })
      .on('end', function () {
        // We're done!
      });

    To restore a dump just use the redis client's restore command for each saved key. You can do that as a single transaction if needed using MULTI.

    Install instructions

    In your project directory run the following command to add this library as a dependency:

    npm install redis-dump-restore --save

    Install

    npm i redis-dump-restore

    DownloadsWeekly Downloads

    54

    Version

    0.2.0

    License

    Apache-2.0

    Last publish

    Collaborators

    • ash2k
    • jtblin