Uso del tipo de datos JSON con el controlador JDBC

Descargar controlador JDBC

A partir de la versión 13.2.0, Microsoft JDBC Driver for SQL Server admite el tipo de datos JSON. Esta característica permite a las aplicaciones Java leer y escribir en columnas de sql Server de tipo json, lo que permite la interacción perfecta con datos semiestructurados.

A continuación se muestran ejemplos de formas de interactuar con los tipos de datos JSON mediante el controlador JDBC.

Rellenar y recuperar datos JSON de una tabla

Para trabajar con datos JSON en SQL Server, empiece por crear una tabla con una columna de tipo json:

CREATE TABLE sampleTable (data JSON);

Inserte un JSON con una declaración

try (Statement stmt = connection.createStatement()) {
    stmt.execute("INSERT INTO sampleTable (data) VALUES ('{\"name\":\"John\",\"skills\":[\"Java\",\"SQL\"]}')");
}

Inserte JSON con una instrucción preparada y parámetros:

String json = "{\"name\":\"John\",\"skills\":[\"Java\",\"SQL\"]}";
String insertSql = "INSERT INTO sampleTable (data) VALUES (?)";

try (PreparedStatement pstmt = connection.prepareStatement(insertSql)) {
    pstmt.setString(1, json);
    pstmt.executeUpdate();
}

Lee datos JSON de la tabla:

String query = "SELECT data FROM sampleTable";

try (PreparedStatement stmt = connection.prepareStatement(query);
     ResultSet rs = stmt.executeQuery()) {
    while (rs.next()) {
        String json = rs.getString("data");
        System.out.println("JSON: " + json);
    }
}

Salida JSON de un procedimiento almacenado

En el ejemplo siguiente se muestra cómo devolver un parámetro de salida json de un procedimiento almacenado.

String sql = "CREATE PROCEDURE sampleProc @p0 JSON OUTPUT AS " +
             " SELECT TOP 1 @p0 = data FROM sampleTable";

Recupere el JSON de salida registrando el parámetro y ejecutando el procedimiento.

try (CallableStatement callableStatement = connection.prepareCall("{call sampleProc (?) }")) {
    callableStatement.registerOutParameter(1, microsoft.sql.Types.JSON);
    callableStatement.execute();
    String outputJson = callableStatement.getString(1);
    System.out.println("Output JSON: " + outputJson);
}

Parámetros con valores de tabla (TVP) con JSON

En este ejemplo se insertan datos JSON con un TVP.

String value = "{\"severity\":\"TRACE\",\"duration\":200,\"date\":\"2024-12-17T15:45:56\"}";

SQLServerDataTable tvp = new SQLServerDataTable();
tvp.addColumnMetadata("c1", microsoft.sql.Types.JSON);
tvp.addRow(value);

try (SQLServerPreparedStatement pstmt = (SQLServerPreparedStatement) connection.prepareStatement(
        "INSERT INTO sampleTable SELECT * FROM ?")) {
    pstmt.setStructured(1, "JsonTVP", tvp);
    pstmt.execute();
}

Uso de SQLServerBulkCopy de la tabla de origen a la tabla de destino con JSON

SQLServerBulkCopy se usa para copiar datos de una tabla de origen que contiene columnas JSON en una tabla de destino.

try (Statement stmt = con.createStatement()) {
    stmt.executeUpdate("CREATE TABLE destinationTable (data JSON)");

    SQLServerBulkCopy bulkCopy = new SQLServerBulkCopy(con);

    bulkCopy.setDestinationTableName("destinationTable");
    bulkCopy.writeToServer(stmt.executeQuery("SELECT * FROM sourceTable"));
}

Utilizar copia masiva con columna JSON desde CSV

Copie y pegue el texto siguiente en un archivo CSV denominado json.csv:

c1,c2,c3
true,sample,"{""field"":""value""}"

Use la copia masiva para insertar los datos CSV en una tabla:

try (Statement stmt = con.createStatement();
     SQLServerBulkCopy bulkCopy = new SQLServerBulkCopy(con);
     SQLServerBulkCSVFileRecord fileRecord = new SQLServerBulkCSVFileRecord("json.csv", null, ",", true)) {

    stmt.executeUpdate("CREATE TABLE sampleTable (c1 JSON)");

    fileRecord.addColumnMetadata(3, "c3", microsoft.sql.Types.JSON);

    fileRecord.setEscapeColumnDelimitersCSV(true);
    bulkCopy.setDestinationTableName("sampleTable");
    bulkCopy.writeToServer(fileRecord);
}

Limitaciones de JSON

Para obtener limitaciones detalladas, consulte Limitaciones del tipo de datos JSON.

Contenido relacionado

• Descripción de los tipos de datos del controlador JDBC