检查备份文件的元数据

您可以使用 `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 存储桶（从 Neo4j 5.19 开始）、Google Cloud 存储桶（从 Neo4j 5.21 开始）和 Azure 存储桶（从 Neo4j 5.24 开始）中的备份。

选项

表 2. `neo4j-admin backup inspect` 选项
选项	描述	默认值
`--additional-config=<file>`	具有附加配置的配置文件。
`--expand-commands`	允许在配置值评估中扩展命令。
`-h, --help`	显示此帮助信息并退出。
`--latest-backup`	仅显示最新的备份。	`false`
`--latest-chain`	列出以最新下载的备份结束的完整备份链。	`false`
`--show-metadata`	显示备份元数据。	`false`
`--database=<database>`	要检查的数据库的名称。
`--format=<value>`	命令输出的格式。可能的值为：'JSON, TABULAR'。	`TABULAR`
`--empty`	包括空备份。	`false`
`--verbose`	启用详细输出。

示例

假设文件夹 *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 |

结果返回一条长度为 2 的链

第一个备份是包含事务范围 [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* 的头中存储的元数据的一部分。