OBJECT_DELETE¶

Sintaxe¶

OBJECT_DELETE( <object>, <key1> [, <key2>, ... ] )

Argumentos¶

object

O objeto de origem.

key1, key2

Chave a ser omitida do objeto retornado.

Retornos¶

Esta função retorna um valor do tipo OBJECT.

Notas de uso¶

Para OBJECTs estruturados:

• Para os argumentos que são chaves, você deve especificar constantes.

• Se a chave especificada não fizer parte da definição do tipo OBJECT, a chamada falhará. Por exemplo, a chamada a seguir falha porque o valor OBJECT não contém a chave especificada zip_code:

  SELECT OBJECT_DELETE( {'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR,state VARCHAR), 'zip_code' );
  

  Copy

  093201 (23001): Function OBJECT_DELETE: expected structured object to contain field zip_code but it did not.
  

• A função retorna um valor OBJECT estruturado. O tipo do valor OBJECT exclui a chave excluída. Por exemplo, suponha que você remova a chave city:

  SELECT
    OBJECT_DELETE(
      {'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR,state VARCHAR),
      'city'
    ) AS new_object,
    SYSTEM$TYPEOF(new_object);
  

  Copy

  A função retorna um valor OBJECT do tipo OBJECT(state VARCHAR), que não inclui a chave city.

  +-----------------+--------------------------------------+
  | NEW_OBJECT      | SYSTEM$TYPEOF(NEW_OBJECT)            |
  |-----------------+--------------------------------------|
  | {               | OBJECT(state VARCHAR(16777216))[LOB] |
  |   "state": "CA" |                                      |
  | }               |                                      |
  +-----------------+--------------------------------------+
  

• Se a função remover todas as chaves do valor OBJECT, a função retornará um valor OBJECT estruturado vazio do tipo OBJECT().

  SELECT
    OBJECT_DELETE(
      {'state':'CA'}::OBJECT(state VARCHAR),
      'state'
    ) AS new_object,
    SYSTEM$TYPEOF(new_object);
  

  Copy

  +------------+---------------------------+
  | NEW_OBJECT | SYSTEM$TYPEOF(NEW_OBJECT) |
  |------------+---------------------------|
  | {}         | OBJECT()[LOB]             |
  +------------+---------------------------+
  

  Quando o tipo de um valor OBJECT estruturado inclui pares chave-valor, os nomes e tipos desses pares são incluídos entre parênteses no tipo (por exemplo, OBJECT(city VARCHAR)). Como um valor OBJECT estruturado vazio não contém pares chave-valor, os parênteses estão vazios.

Exemplos¶

Essa consulta retorna um objeto que exclui as chaves a e b do objeto de origem:

SELECT OBJECT_DELETE(OBJECT_CONSTRUCT('a', 1, 'b', 2, 'c', 3), 'a', 'b') AS object_returned;

+-----------------+
| OBJECT_RETURNED |
|-----------------|
| {               |
|   "c": 3        |
| }               |
+-----------------+

Crie uma tabela e insira linhas com os valores de OBJECT. Este exemplo usa Constantes OBJECT nas instruções INSERT.

CREATE OR REPLACE TABLE object_delete_example (
  id INTEGER,
  ov OBJECT);

INSERT INTO object_delete_example (id, ov)
  SELECT
    1,
    {
      'employee_id': 1001,
      'employee_date_of_birth': '12-10-2003',
      'employee_contact':
        {
          'city': 'San Mateo',
          'state': 'CA',
          'phone': '800-555‑0100'
        }
    };

INSERT INTO object_delete_example (id, ov)
  SELECT
    2,
    {
      'employee_id': 1002,
      'employee_date_of_birth': '01-01-1990',
      'employee_contact':
        {
          'city': 'Seattle',
          'state': 'WA',
          'phone': '800-555‑0101'
        }
    };

Consulte a tabela para ver os dados:

SELECT * FROM object_delete_example;

+----+-------------------------------------------+
| ID | OV                                        |
|----+-------------------------------------------|
|  1 | {                                         |
|    |   "employee_contact": {                   |
|    |     "city": "San Mateo",                  |
|    |     "phone": "800-555‑0100",              |
|    |     "state": "CA"                         |
|    |   },                                      |
|    |   "employee_date_of_birth": "12-10-2003", |
|    |   "employee_id": 1001                     |
|    | }                                         |
|  2 | {                                         |
|    |   "employee_contact": {                   |
|    |     "city": "Seattle",                    |
|    |     "phone": "800-555‑0101",              |
|    |     "state": "WA"                         |
|    |   },                                      |
|    |   "employee_date_of_birth": "01-01-1990", |
|    |   "employee_id": 1002                     |
|    | }                                         |
+----+-------------------------------------------+

Para excluir a chave employee_date_of_birth da saída da consulta, execute a seguinte consulta:

SELECT id,
       OBJECT_DELETE(ov, 'employee_date_of_birth') AS contact_without_date_of_birth
  FROM object_delete_example;

+----+-------------------------------+
| ID | CONTACT_WITHOUT_DATE_OF_BIRTH |
|----+-------------------------------|
|  1 | {                             |
|    |   "employee_contact": {       |
|    |     "city": "San Mateo",      |
|    |     "phone": "800-555‑0100",  |
|    |     "state": "CA"             |
|    |   },                          |
|    |   "employee_id": 1001         |
|    | }                             |
|  2 | {                             |
|    |   "employee_contact": {       |
|    |     "city": "Seattle",        |
|    |     "phone": "800-555‑0101",  |
|    |     "state": "WA"             |
|    |   },                          |
|    |   "employee_id": 1002         |
|    | }                             |
+----+-------------------------------+

Para consultar o objeto aninhado employee_contact e remover a chave phone dele, execute a seguinte consulta:

SELECT id,
       OBJECT_DELETE(ov:"employee_contact", 'phone') AS contact_without_phone
  FROM object_delete_example;

+----+------------------------+
| ID | CONTACT_WITHOUT_PHONE  |
|----+------------------------|
|  1 | {                      |
|    |   "city": "San Mateo", |
|    |   "state": "CA"        |
|    | }                      |
|  2 | {                      |
|    |   "city": "Seattle",   |
|    |   "state": "WA"        |
|    | }                      |
+----+------------------------+