本文介绍如何将数据从嬴图数据库导出到CSV文件。

以下步骤均在Windows系统上PowerShell中演示。

生成配置文件

打开终端程序，导航至ultipa-exporter所在文件夹。执行以下命令，生成数据导出样本配置文件：

./ultipa-exporter --sample

执行命令后，会在ultipa-exporter所在目录下生成配置文件export.sample.yml。如果目录下已有该文件，数据将被覆盖。

修改配置文件

根据实际使用场景修改export.sample.yml文件。该文件包含以下部分：

• server：提供嬴图服务器信息，并指定数据导出的目标图。
• sftp：配置存储CSV文件的SFTP服务器。若将文件导出至本地计算机，请删除此部分或留空。
• nodeConfig：选择导出的点schema和点属性。
• edgeConfig：选择导出的边schema和边属性。
• settings：为数据导出设置全局参数和偏好。

# 嬴图服务器配置
server:
  # 主机IP/URI和端口；若为集群，使用英文逗号分隔
  host: "10.11.22.33:1234"
  username: "admin"
  password: "admin12345"
  # 数据导出目标图
  graphset: "trading"
  # TLS加密证书文件路径
  crt: ""

# SFTP服务器配置
# 若文件保存在本地计算机，请删除此部分或留空
sftp:
  # 主机IP/URI和端口
  host: 
  username: 
  password: 
  # SFTP的SSH密钥路径（若设置了密钥路径，将不再使用密码）
  key: 

# 点配置
nodeConfig:
  # 指定schema；设置为“*”时导出所有schema和属性
  - schema: "Customer"
    # 指定属性；若未设置，导出所有属性
    properties:
      - name: name
  - schema: "Merchant"

# 边配置
edgeConfig:
  - schema: "Transfers"
    properties:
      - name: trans_no

# 全局设置     
settings:
  # 文件类型：csv/json/jsonl/graphml
  fileType: csv
  # 文件是否包含表头
  writeHeader: true
  # 导出文件路径。若配置了SFTP，则使用SFTP路径
  outPath: "./exported"
  # 报错时停止数据导出
  stopWhenError: true
  # 最大线程数
  threads: 32
  # RPC最大消息传输量（单位：MB）
  maxPacketSize: 40
  # 导出大型数据集数据时，gRPC超时限制（单位：秒）
  timeout: 1000
  # 时间戳单位，支持毫秒（ms）或秒（s）
  timestampUnit: s

执行导出

使用--config标志指定配置文件，执行数据导出：

./ultipa-exporter --config export.sample.yml