load-avro

---
title: Loading Avro into Databend
sidebar_label: Avro
---

## 什么是 Avro？

[Apache Avro™](https://avro.apache.org/) 是领先的记录数据序列化格式，也是流数据管道的首选。

## 加载 Avro 文件

加载 AVRO 文件的常用语法如下：

```sql
COPY INTO [<database>.]<table_name>
     FROM { internalStage | externalStage | externalLocation }
[ PATTERN = '<regex_pattern>' ]
FILE_FORMAT = (TYPE = AVRO)

有关语法的更多详细信息，请参见 COPY INTO table。

教程：从远程 HTTP URL 将 Avro 数据加载到 Databend

在本教程中，你将使用 Avro schema 在 Databend 中创建一个表，并直接通过 HTTPS 从 GitHub 托管的 .avro 文件加载 Avro 数据。

第 1 步：查看 Avro Schema

在 Databend 中创建表之前，让我们快速浏览一下我们正在使用的 Avro schema：userdata.avsc。此 schema 定义了一个名为 User 的记录，其中包含 13 个字段，主要为字符串类型，以及 int 和 float 类型。

{
  "type": "record",
  "name": "User",
  "fields": [
    {"name": "registration_dttm", "type": "string"},
    {"name": "id", "type": "int"},
    {"name": "first_name", "type": "string"},
    {"name": "last_name", "type": "string"},
    {"name": "email", "type": "string"},
    {"name": "gender", "type": "string"},
    {"name": "ip_address", "type": "string"},
    {"name": "cc", "type": "string"},
    {"name": "country", "type": "string"},
    {"name": "birthdate", "type": "string"},
    {"name": "salary", "type": "float"},
    {"name": "title", "type": "string"},
    {"name": "comments", "type": "string"}
  ]
}

第 2 步：在 Databend 中创建表

创建一个与 schema 中定义的结构匹配的表：

CREATE TABLE userdata (
  registration_dttm STRING,
  id INT,
  first_name STRING,
  last_name STRING,
  email STRING,
  gender STRING,
  ip_address STRING,
  cc VARIANT,
  country STRING,
  birthdate STRING,
  salary FLOAT,
  title STRING,
  comments STRING
);

第 3 步：从远程 HTTPS URL 加载数据

COPY INTO userdata
FROM 'https://raw.githubusercontent.com/Teradata/kylo/master/samples/sample-data/avro/userdata1.avro'
FILE_FORMAT = (type = avro);

┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                             File                             │ Rows_loaded │ Errors_seen │    First_error   │ First_error_line │
├──────────────────────────────────────────────────────────────┼─────────────┼─────────────┼──────────────────┼──────────────────┤
│ Teradata/kylo/master/samples/sample-data/avro/userdata1.avro │        1000 │           0 │ NULL             │             NULL │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

第 4 步：查询数据

现在，你可以浏览刚刚导入的数据：

SELECT id, first_name, email, salary FROM userdata LIMIT 5;

┌───────────────────────────────────────────────────────────────────────────────────┐
│        id       │    first_name    │           email          │       salary      │
├─────────────────┼──────────────────┼──────────────────────────┼───────────────────┤
│               1 │ Amanda           │ ajordan0@com.com         │          49756.53 │
│               2 │ Albert           │ afreeman1@is.gd          │         150280.17 │
│               3 │ Evelyn           │ emorgan2@altervista.org  │         144972.52 │
│               4 │ Denise           │ driley3@gmpg.org         │          90263.05 │
│               5 │ Carlos           │ cburns4@miitbeian.gov.cn │              NULL │
└───────────────────────────────────────────────────────────────────────────────────┘