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

AWS Glue 結構描述登錄檔

所以此 AWS Glue 結構描述登錄檔可讓您集中探索、控制和發展資料串流結構描述。結構描述定義資料記錄的結構和格式。使用 AWS Glue 結構描述登錄檔，您可以使用與 Apache Kafka、、Amazon Managed Streaming for Apache KafkaAmazon Kinesis Data Streams、Amazon Managed Service for Apache Flink 和 的方便整合，管理和強制執行資料串流應用程式的結構描述AWS Lambda。

結構描述登錄檔支援 AVRO(v1.10.2) 資料格式、結構描述的JSON具有結構描述格式JSON的資料格式 （規格 Draft-04, Draft-06 和 Draft-07)，以及使用 Everit 程式庫的JSON結構描述驗證、Pro Protocol Buffers (Protobuf) 版本 proto2 和 proto3 而不支援 extensions或 groups，以及 Java 語言支援的其他資料格式和語言。支援的功能包括相容性、透過中繼資料取得結構描述、自動註冊結構描述、IAM相容性，以及減少儲存和資料傳輸的選用ZLIB壓縮。結構描述登錄檔是無伺服器且可免費使用的。

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

結構描述登錄允許不同的系統共用用於序列化和取消序列化的結構描述。例如，假設您擁有資料的生產者和消費者。生產者在發佈資料時知道結構描述。結構描述登錄檔為 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" 
                    }
                ]
            }
        }
    ]
}

在此範例中，結構描述的 draft-07 適用於 JSON 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 Resource Name (ARN)，可讓您在登錄檔中組織和設定結構描述操作的不同存取許可。

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

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

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

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

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

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

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

開源 Serde 程式庫

AWS 提供開放原始碼 Serde 程式庫，做為序列化和還原序列化資料的架構。這些程式庫的開源設計允許通用的開源應用程式和架構在他們的專案中支援這些程式庫。

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

結構描述登錄檔的配額

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

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

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

您可以使用 或 PutSchemaVersionMetadata 動作 (Python： put_schema_version_metadata) 來檢視QuerySchemaVersionMetadata 動作 (Python： query_schema_version_metadata)或設定鍵值中繼資料對APIs。

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

登錄檔

此帳戶每個 AWS 區域最多可以有 100 個註冊。

SchemaVersion

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

每個新結構描述都會建立新的結構描述版本，因此假設每個區域每個帳戶最多可以有 10000 個結構描述，如果每個結構描述只有一個版本。

結構描述承載

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