Розгортання напівструктурованих даних

Типи даних і функції в Snowflake

Jake Roach

Field Data Engineer

Структуровані дані

     school_id  |    school_name    |  street_number  |  street_name  |  suffix   |      city      |  zip_code
    ----------- | ----------------- | --------------- | ------------- | --------- | -------------- | ----------
      s_19219   |  West Aurora HS   |       879       |    Main       |    St.    |  West Aurora   |   25041
      s_77465   |  Springtown HS    |      1645       |    Cherry     |    Rd.    |  Springtown    |   14556

     school_id  |                address_info        
    ----------- | ------------------------------------------
      s_19219   |    {
                |        "school_name": "West Aurora HS",
                |        "address": {
                |            "street_number": 879,
                |            "street_name": "Main",
                |            "suffix":  "St."
                |            "city": "West Aurora",
                |            "zip_code": 25041
                |        }
                |    }

Напівструктуровані дані

Дані в дужках із парами ключ—значення мають тип VARIANT

{
    "school_name": "West Aurora HS",
    "address": {  -- Nested object
        "street_number": 879,
        "street_name": "Main",
        "suffix": "St.",
        "city": "West Aurora",
        "zip_code": 25041
    }
}

Як словник Python або об'єкт JSON
Дозволяє зберігати дані у «сирому» форматі
Можна вкладати об'єкти, як-от address
Отримання даних двома способами

Dot-notation

                  my_column  
 -------------------------------------------
        {
            "my_first_key": 2025,
            "my_second_key": {
                "a": "alpha",
                "b": "bravo"
            }
        }

SELECT

    my_column:my_first_key         -- Top-level

    my_column:my_second_key.a   -- Nested
    my_column:my_second_key.b   -- Nested

...

Полегшує вибір верхнього рівня та вкладених значень із даних VARIANT

Двокрапка розділяє <column-name>:<top-level-key>
Додайте . і назву вкладеного поля: <column-name>:<top-level-key>.<nested-key>
Отримуйте глибоко вкладені значення

Dot-notation

SELECT
    address_info:school_name,                              -- Top-level, dot-notation

    address_info:address.street_number AS street_number,   -- Nested, dot-notation
    address_info:address.street_name AS street_name,
    address_info:address.suffix AS suffix

FROM SCHOOLS.school_info;

              school_name    |  street_number  |  street_name  |  suffix  
           ----------------- | --------------- | ------------- | ---------
            West Aurora HS   |       879       |    Main       |    St.   
            Springtown HS    |      1645       |    Cherry     |    Rd.

Bracket-notation

Надає ще один спосіб отримувати значення верхнього рівня та вкладені значення

<column-name>['<top-level-key']['...']
Багато рівнів вкладеності
Подібно до доступу до словника Python
Використовуйте лише одинарні лапки (')!

                    my_column  
 ------------------------------------------------
          {
              "my_first_key": 2025,
               my_second_key": {
                  "a": "alpha",
                  "b": "bravo"
              }
          }

SELECT

    my_column['my_first_key'],       -- Top-level

    my_column['my_second_key']['a']   -- Nested
    my_column['my_second_key']['b']   -- Nested

...

Bracket-notation

SELECT

    address_info['school_name'],                      -- Top-level, bracket-notation


    address_info['address']['city'] AS city,           -- Nested, bracket-notation
    address_info['address']['zip_code'] AS zip_code


FROM SCHOOLS.school_info;

                     school_name    |      city      |  zip_code
                  ----------------- | -------------- | ----------
                   West Aurora HS   |  West Aurora   |   25041
                   Springtown HS    |  Springtown    |   14556

Перетворення напівструктурованих даних

SELECT
    school_id,

    address_info:school_name AS school_name,               -- Top-level, dot-notation

    address_info:address.street_number AS street_number,   -- Nested, dot-notation
    address_info:address.street_name AS street_name,
    address_info:address.suffix AS suffix,

    address_info['address']['city'] AS city,               -- Nested, bracket-notation
    address_info['address']['zip_code'] AS zip_code

FROM SCHOOLS.school_info;

Перетворення напівструктурованих даних

     school_id  |                address_info        
    ----------- | ------------------------------------------
      s_19219   |    {
                |        "school_name": "West Aurora HS",
                |        "address": {
                |            "street_number": 879,
                |            "street_name": "Main",
                |            "suffix":  "St."
                |            "city": "West Aurora",
                |            "zip_code": 25041
                |        }
                |    }

     school_id  |    school_name    |  street_number  |  street_name  |  suffix   |      city      |  zip_code
    ----------- | ----------------- | --------------- | ------------- | --------- | -------------- | ----------
      s_19219   |  West Aurora HS   |       879       |    Main       |    St.    |  West Aurora   |   25041
      s_77465   |  Springtown HS    |      1645       |    Cherry     |    Rd.    |  Springtown    |   14556

Давайте потренуємось!

Типи даних і функції в Snowflake