Avroスキーマ定義はJSONレコードです。レコードなので、JSON配列に編成された複数のフィールドで定義できます。この各フィールドでは、フィールド名とフィールド型を指定します。フィールド型には、整数のような単純なものや、別のレコードのような複雑なものを設定できます。

たとえば、次の簡単なAvroスキーマ定義は、人の年齢のみを含む値に使用できます。

{
    "type" : "record",
    "name" : "userInfo",
    "namespace" : "my.example",
    "fields" : [{"name" : "age", "type" : "int"}]
} 

データ格納の要件がこのように単純な場合は、整数を単なるバイト配列でストアに格納することもできます。(ただし、これはベスト・プラクティスではありません。)

前述の例で、単一フィールドのスキーマを定義している場合でも、スキーマ定義の最上位の型はrecord型であることに注意してください。Oracle NoSQL Databaseでは、必要なフィールドが1つのみでも、最上位の型にはrecordを使用する必要があります。

また、スキーマのフィールドにはデフォルト値を定義しておくことをお薦めします。これはオプションですが、スキーマを変更する可能性がある場合は、そうすることで様々な問題を回避できます。デフォルト値を定義するには、default属性を使用します。

{
    "type" : "record",
    "name" : "userInfo",
    "namespace" : "my.example",
    "fields" : [{"name" : "age", "type" : "int", "default" : -1}]
}

単一フィールドの定義を使用することはほとんどありません。複数のフィールドを追加するには、fieldsフィールドに配列を指定します。次に例を示します。

{
    "type" : "record",
    "name" : "userInfo",
    "namespace" : "my.example",
    "fields" : [{"name" : "username", 
                "type" : "string", 
                "default" : "NONE"},

                {"name" : "age", 
                "type" : "int", 
                "default" : -1},

                {"name" : "phone", 
                "type" : "string", 
                "default" : "NONE"},

                {"name" : "housenum", 
                "type" : "string", 
                "default" : "NONE"},

                {"name" : "street", 
                "type" : "string", 
                "default" : "NONE"},

                {"name" : "city", 
                "type" : "string", 
                "default" : "NONE"},

                {"name" : "state_province", 
                "type" : "string", 
                "default" : "NONE"},

                {"name" : "country", 
                "type" : "string", 
                "default" : "NONE"},

                {"name" : "zip", 
                "type" : "string", 
                "default" : "NONE"}]
} 

前述のスキーマ定義には様々な情報が含まれています。このように単純ですが、埋込みレコードを使用すれば、さらに構造を追加できます。

{
    "type" : "record",
    "name" : "userInfo",
    "namespace" : "my.example",
    "fields" : [{"name" : "username", 
                 "type" : "string", 
                 "default" : "NONE"},

                {"name" : "age", 
                 "type" : "int",
                 "default" : -1},

                 {"name" : "phone", 
                  "type" : "string", 
                  "default" : "NONE"},

                 {"name" : "housenum", 
                  "type" : "string", 
                  "default" : "NONE"},

                  {"name" : "address", 
                   "type" : {
                         "type" : "record",
                         "name" : "mailing_address",
                         "fields" : [
                            {"name" : "street", 
                             "type" : "string", 
                             "default" : "NONE"},

                            {"name" : "city", 
                             "type" : "string", 
                             "default" : "NONE"},

                            {"name" : "state_prov", 
                             "type" : "string", 
                             "default" : "NONE"},

                            {"name" : "country", 
                             "type" : "string", 
                             "default" : "NONE"},

                            {"name" : "zip", 
                             "type" : "string", 
                             "default" : "NONE"}
                          ]},
                          "default" : {}
                }
    ]
} 

前述のAvroスキーマの例では、文字列と整数のみを示しました。次に、Avroでサポートされているプリミティブ型の完全なリストを示します。

これらのプリミティブ型には固有の属性がありません。プリミティブ型の名前は、型名の定義でもあります。たとえば、スキーマstringは、次と同等です。

{"type" : "string"}

前の項で説明したプリミティブ・データ型の他に、Avroでは6つの複合データ型(Record、Enum、Array、Map、UnionおよびFixed)をサポートしています。これらについてはこの項で説明します。

{ "type" : "enum",
  "name" : "Colors",
  "namespace" : "palette",
  "doc" : "Colors supported by the palette.",
  "symbols" : ["WHITE", "BLUE", "GREEN", "RED", "BLACK"]}

{"type" : "array", "items" : "string"}

{"type" : "map", "values" : "int"}

["string", "null"]

{
     "type": "record",
     "namespace": "com.example",
     "name": "FullName",
     "fields": [
       { "name": "first", "type": ["string", "null"] },
       { "name": "last", "type": "string", "default" : "Doe" }
     ]
} 

{"type" : "fixed" , "name" : "bdata", "size" : 1048576}