本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS Glue架構登錄

S AWS Glue chema 登錄可讓您集中探索、控制和發展資料串流結構描述。結構描述定義資料記錄的結構和格式。透過AWS Glue結構描述登錄，您可以使用與 Apache Kafka、Amazon Kinesis 資料串流、Ap ache Flink 的亞馬遜受管服務和整合 Amazon Managed Streaming for Apache Kafka，在資料串流應用程式上管理和強制執行結構描述。AWS Lambda

架構註冊表支持AVRO（v1.10.2）數據格式，具有JSON模式格式的JSON數據格式（規格草稿 04，草稿 06 和草稿 07），使用 Everit 庫，協議緩衝區（Protobuf）版本 proto2 和 proto3 版本，而不支持extensions或groups，以及 Java 語言支持以及未來的其他數據格式和語言。JSON支援的功能包括相容性、透過中繼資料擷取結構描述、自動註冊結構描述、IAM相容性以及可選的ZLIB壓縮，以減少儲存和資料傳輸。Schema 登錄檔是無伺服器且可免費使用。

使用結構描述作為生產者與消費者之間的資料格式合約，可改善資料控管、更高品質的資料，並讓資料消費者能夠彈性相容上游變更。

Schema 註冊表允許不同的系統共享序列化和反序列化的模式。例如，假設您擁有資料的生產者和消費者。生產者在發佈資料時知道結構描述。架構註冊表為某些系統（如 Amazon MSK 或 Apache Kafka）提供序列化程序和反序列化程序。

如需詳細資訊，請參閱結構描述登錄的運作方式。

結構描述

結構描述定義資料記錄的結構和格式。結構描述是可靠的資料發佈、耗用或儲存的版本化規格。

在 Avro 的這個範例結構描述中，格式和結構由配置和欄位名稱定義，欄位名稱的格式由資料類型定義 (例如，string、int)。

{
    "type": "record",
    "namespace": "ABC_Organization",
    "name": "Employee",
    "fields": [
        {
            "name": "Name",
            "type": "string"
        },
        {
            "name": "Age",
            "type": "int"
        },
        {
            "name": "address",
            "type": {
                "type": "record",
                "name": "addressRecord",
                "fields": [
                    {
                        "name": "street",
                        "type": "string"
                    },
                    {
                        "name": "zipcode",
                        "type": "int" 
                    }
                ]
            }
        }
    ]
}

在此範例JSON結構描述草稿 -07 中JSON，格式是由JSON結構描述組織所定義。

{
	"$id": "https://example.com/person.schema.json",
	"$schema": "http://json-schema.org/draft-07/schema#",
	"title": "Person",
	"type": "object",
	"properties": {
		"firstName": {
			"type": "string",
			"description": "The person's first name."
		},
		"lastName": {
			"type": "string",
			"description": "The person's last name."
		},
		"age": {
			"description": "Age in years which must be equal to or greater than zero.",
			"type": "integer",
			"minimum": 0
		}
	}
}

在這個 Protobuf 範例中，格式由協定緩衝區語言的版本 2 (proto2) 定義。

syntax = "proto2";

package tutorial;

option java_multiple_files = true;
option java_package = "com.example.tutorial.protos";
option java_outer_classname = "AddressBookProtos";

message Person {
  optional string name = 1;
  optional int32 id = 2;
  optional string email = 3;

  enum PhoneType {
    MOBILE = 0;
    HOME = 1;
    WORK = 2;
  }

  message PhoneNumber {
    optional string number = 1;
    optional PhoneType type = 2 [default = HOME];
  }

  repeated PhoneNumber phones = 4;
}

message AddressBook {
  repeated Person people = 1;
}

登錄檔

登錄檔是結構描述的邏輯容器。登錄檔允許您組織您的結構描述，以及管理應用程式的存取控制。登錄具有 Amazon 資源名稱 (ARN)，可讓您組織和設定登錄內結構描述操作的不同存取權限。

您可以使用預設登錄檔，或視需要建立許多新的登錄檔。

結構描述版本控制和相容性

每個結構描述可以有多個版本。版本控制是由套用在結構描述上的相容性規則所控制。結構描述登錄檔會根據此規則檢查登錄新結構描述版本的要求，然後才能成功。

標示為檢查點的結構描述版本是用來判斷註冊新結構描述版本的相容性。第一次建立結構描述時，預設檢查點將是第一個版本。隨著結構描述隨著更多版本而發展，您可以使用CLI/SDK將檢查點變更為結構描述的版本，使用遵循一組條UpdateSchemaAPI件約束的結構描述。在主控台中，編輯結構描述定義或相容性模式預設會將檢查點變更為最新版本。

相容性模式可讓您控制結構描述可以或不可以隨著時間變化的方式。這些模式形成應用程式產生和使用資料之間的合約。當新版的結構描述提交至登錄檔時，會使用套用至結構描述名稱的相容性規則來判斷是否可以接受新版本。共有 8 種相容模式：NONEDISABLEDBACKWARD、ALL、FORWARD、BACKWARD FORWARD _ ALL、_ FULL、FULL _ ALL。

在 Avro 資料格式中，欄位可以是選用的或必要的。選用欄位是其中 Type 包含 null。必要欄位的 Type 沒有 null。

在 Protobuf 資料格式中，proto2 語法中的欄位可以是選用 (包括重複) 或必要欄位，而 proto3 語法中的所有欄位均是選用 (包括重複) 欄位。所有相容性規則均是根據對協定緩衝區規範的理解以及 Google 協定緩衝區文件中的指導所決定。

開源 Serde 程式庫

AWS 提供開源 Serde 庫作為序列化和反序列化數據的框架。這些程式庫的開源設計允許通用的開源應用程式和架構在他們的專案中支援這些程式庫。

如需 Serde 函式庫如何運作的詳細資訊，請參閱結構描述登錄的運作方式。

結構描述登錄檔的配額

配額 (在中 AWS也稱為限制) 是您 AWS 帳戶中資源、動作和項目的最大值。下列是 AWS Glue 中結構描述登錄檔的軟性限制。

結構描述版本中繼資料索引鍵-值對

每個 AWS 區域最多可以有 10 SchemaVersion 個鍵值對。

您可以使用或來檢視或設定鍵值中繼資料配對。QuerySchemaVersionMetadata 行動（Python：查詢模式版本的元數據） PutSchemaVersionMetadata 行動（Python：放置版本的元數據） APIs

下列是 AWS Glue 中結構描述登錄檔的硬性限制。

登錄檔

此帳戶的每個 AWS 區域最多可有 100 個登錄。

SchemaVersion

此帳戶的每個 AWS 區域最多可以有 10000 個結構描述版本。

每個新模式都會創建一個新的模式版本，因此理論上，如果每個模式只有一個版本，則每個區域每個帳戶最多可以有 10000 個模式。

結構描述承載

結構描述裝載的大小限制為 170 KB。