检查备份文件的元数据

您可以使用 neo4j-admin backup inspect 命令检查数据库备份文件的元数据。

命令

inspect 命令列出存储在备份文件头部的元数据。此元数据主要定义备份如何连接以形成备份链。备份链是一个或多个逻辑连接的备份序列。该序列的顺序保证了在重放时（参见恢复或聚合），存储和事务数据以一致的方式被使用。

元数据包含以下信息

数据库：备份中包含的数据库片段的数据库名称。
数据库ID：用于区分数据库（即使名称相同）的唯一标识符。
时间：备份发生的时间。
完整性：指示是完整备份（即包含存储文件的初始备份）还是差异备份（即仅包含要应用于存储文件的事务的后续备份）。
已压缩：指示备份文件中的备份数据是否已压缩。
最低事务ID：当备份是完整备份时，此值始终为 1；当它是差异备份时，该值对应于备份开始时的第一个事务 ID。
最高事务ID：类似地，此值表示存储在备份文件中的最后一个事务 ID。

语法

neo4j-admin backup inspect [-h] [--empty] [--expand-commands] [--latest-backup]
                           [--latest-chain] [--show-metadata] [--verbose]
                           [--additional-config=<file>] [--database=<database>]
                           [--format=<value>] <backup-path>

描述

读取备份元数据的命令。

参数

表 1. `neo4j-admin backup inspect` 参数
参数	描述
`<backup-path>`	表示备份存储目录或要检查的单个备份的路径。

<backup-path> 参数还可以检查存储在 AWS S3 存储桶、Google Cloud 存储桶和 Azure 存储桶中的备份。

选项

表 2. `neo4j-admin backup inspect` 选项
选项	描述	默认值
`--additional-config=<file>^[1]`	包含附加配置的配置文件。
`--expand-commands`	允许在配置值评估中展开命令。
`-h, --help`	显示此帮助消息并退出。
`--latest-backup`	仅显示最新备份。	`false`
`--latest-chain`	列出以最新下载备份结尾的完整备份链。	`false`
`--show-metadata`	显示备份元数据。	`false`
`--database=<database>`	要检查的数据库名称。
`--format=<value>`	命令输出的格式。可能的值有：“JSON, TABULAR”。	`TABULAR`
`--empty`	包含空备份。	`false`
`--verbose`	启用详细输出。
1. 有关详细信息，请参见Neo4j Admin 和 Neo4j CLI → 配置。

--latest-backup 和 --latest-chain 选项不能同时使用。

示例

给定文件夹 /backups 包含一组数据库备份

/backups
├── london-2024-10-07T16-03-51.backup
├── london-2024-10-07T16-04-05.backup
├── malmo-2024-10-07T16-00-07.backup
├── malmo-2024-10-07T16-00-19.backup
├── malmo-2024-10-07T16-00-34.backup
├── malmo-2024-10-07T16-00-44.backup
├── malmo-2024-10-07T16-00-50.backup
├── malmo-2024-10-07T16-01-08.backup
├── malmo-2024-10-07T16-01-24.backup
└── neo4j-2024-10-07T16-05-37.backup

列出备份文件的元数据

以下命令列出备份文件的名称及其各自的元数据

bin/neo4j-admin backup inspect /backups --show-metadata --empty

--empty 选项用于包含空备份。当数据库被备份但没有新数据时，会创建一个空备份。空备份用于记录备份历史。

示例输出

|                                              FILE | DATABASE |                          DATABASE ID |          TIME (UTC) |  FULL | COMPRESSED | LOWEST TX | HIGHEST TX |
|  file:///backups/neo4j-2024-10-07T16-05-37.backup |    neo4j | 7dcb1d0c-4374-4476-b8ae-d3c3f124683f | 2024-10-07T16:05:37 |  true |       true |         1 |          3 |
|  file:///backups/malmo-2024-10-07T16-01-24.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:01:24 |  true |       true |         1 |          8 |
|  file:///backups/malmo-2024-10-07T16-01-08.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:01:08 |  true |       true |         1 |          7 |
|  file:///backups/malmo-2024-10-07T16-00-50.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:00:50 | false |       true |         0 |          0 |
|  file:///backups/malmo-2024-10-07T16-00-44.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:00:44 | false |       true |         7 |          7 |
|  file:///backups/malmo-2024-10-07T16-00-34.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:00:34 | false |       true |         6 |          6 |
|  file:///backups/malmo-2024-10-07T16-00-19.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:00:19 | false |       true |         0 |          0 |
|  file:///backups/malmo-2024-10-07T16-00-07.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:00:07 |  true |       true |         1 |          5 |
| file:///backups/london-2024-10-07T16-04-05.backup |   london | d4dae73c-dfef-4d28-88cd-fe6cc88ddca1 | 2024-10-07T16:04:05 | false |       true |         6 |          6 |
| file:///backups/london-2024-10-07T16-03-51.backup |   london | d4dae73c-dfef-4d28-88cd-fe6cc88ddca1 | 2024-10-07T16:03:51 |  true |       true |         1 |          5 |

列出最新备份

要仅列出每个数据库执行的最新备份，请使用 --latest-backup 选项。

bin/neo4j-admin backup inspect /backups --show-metadata --latest-backup

示例输出

|                                              FILE | DATABASE |                          DATABASE ID |          TIME (UTC) |  FULL | COMPRESSED | LOWEST TX | HIGHEST TX |
|  file:///backups/neo4j-2024-10-07T16-05-37.backup |    neo4j | 7dcb1d0c-4374-4476-b8ae-d3c3f124683f | 2024-10-07T16:05:37 |  true |       true |         1 |          3 |
|  file:///backups/malmo-2024-10-07T16-01-24.backup |    malmo | 62d1820c-3ac6-4b15-a0b3-bf7e7becc8d0 | 2024-10-07T16:01:24 |  true |       true |         1 |          8 |
| file:///backups/london-2024-10-07T16-04-05.backup |   london | d4dae73c-dfef-4d28-88cd-fe6cc88ddca1 | 2024-10-07T16:04:05 | false |       true |         6 |          6 |

检查备份链

备份链对应于一个或多个通过事务 ID 逻辑连接的备份序列。要检查给定数据库的备份链，请使用 --latest-chain 选项和 --database 选项以及您要检查其备份链的数据库名称。

bin/neo4j-admin backup inspect /backups --show-metadata --latest-chain --database=london

示例输出

|                                              FILE | DATABASE |                          DATABASE ID |          TIME (UTC) |  FULL | COMPRESSED | LOWEST TX | HIGHEST TX |
| file:///backups/london-2024-10-07T16-04-05.backup |   london | d4dae73c-dfef-4d28-88cd-fe6cc88ddca1 | 2024-10-07T16:04:05 | false |       true |         6 |          6 |
| file:///backups/london-2024-10-07T16-03-51.backup |   london | d4dae73c-dfef-4d28-88cd-fe6cc88ddca1 | 2024-10-07T16:03:51 |  true |       true |         1 |          5 |

结果返回一个大小为二的链

第一个备份是完整备份，包含事务范围 [1,5] 内的存储文件。
第二个备份是差异备份，仅包含对存储文件的后续修改。这些修改通过一系列要应用的事务来实现。其范围是 [6,6]。

检查以特定备份结尾的备份链

要检查以特定备份结尾的备份链，请按如下方式使用 --latest-chain 选项。

bin/neo4j-admin backup inspect /backups/london-2024-10-07T16-04-05.backup  --show-metadata --latest-chain

示例输出

|                                              FILE | DATABASE |                          DATABASE ID |          TIME (UTC) |  FULL | COMPRESSED | LOWEST TX | HIGHEST TX |
| file:///backups/london-2024-10-07T16-04-05.backup |   london | d4dae73c-dfef-4d28-88cd-fe6cc88ddca1 | 2024-10-07T16:04:05 | false |       true |         6 |          6 |
| file:///backups/london-2024-10-07T16-03-51.backup |   london | d4dae73c-dfef-4d28-88cd-fe6cc88ddca1 | 2024-10-07T16:03:51 |  true |       true |         1 |          5 |

在这种情况下，--database 选项是不必要的，因为数据库标识符是存储在备份文件 london-2024-10-07T16-04-05.backup 头部元数据的一部分。