Função SQL Oracle JSON_TRANSFORM

Introdução

A função JSON_TRANSFORM no Oracle Database é usada para modificar um documento JSON existente de acordo com as especificações fornecidas. Esta função permite atualizar, inserir ou remover elementos de um documento JSON de forma programática e flexível.

Descrição da Função

A função JSON_TRANSFORM aplica uma transformação especificada a um documento JSON. Você pode usar esta função para alterar o conteúdo de um JSON sem ter que reescrever o documento inteiro.

A sintaxe básica da função é a seguinte:

JSON_TRANSFORM(json_expr, json_transform_expr [, format])

Onde:

• json_expr é a expressão JSON a ser transformada.
• json_transform_expr é a expressão que especifica a transformação a ser aplicada.
• format é um parâmetro opcional que define o formato de saída (por exemplo, JSON ou JSON_TEXT).

Exemplos de Uso

Veja alguns exemplos práticos de como usar a função JSON_TRANSFORM:

Exemplo 1: Atualizando um Valor no JSON

-- Atualizando o valor de uma chave em um documento JSON SELECT JSON_TRANSFORM( '{"name": "Alice", "age": 28}', '$.age = 30' ) AS updated_json FROM dual;

Exemplo 2: Adicionando um Novo Campo ao JSON

-- Adicionando um novo campo ao documento JSON SELECT JSON_TRANSFORM( '{"name": "Alice", "age": 28}', '$.city = "San Francisco"' ) AS updated_json FROM dual;

Exemplo 3: Removendo um Campo do JSON

-- Removendo um campo do documento JSON SELECT JSON_TRANSFORM( '{"name": "Alice", "age": 28, "city": "San Francisco"}', '$.city = null' ) AS updated_json FROM dual;

Considerações

Ao usar JSON_TRANSFORM, considere o impacto nas consultas e na integridade dos dados. A função é útil para ajustes dinâmicos e atualizações parciais de documentos JSON, mas deve ser usada com cuidado para evitar inconsistências no formato dos dados.

Referências

Para mais detalhes sobre a função JSON_TRANSFORM, consulte a Documentação Oficial da Oracle.