JSON-gegevenstype gebruiken met het JDBC-stuurprogramma

JDBC-stuurprogramma downloaden

Vanaf versie 13.2.0 ondersteunt het Microsoft JDBC-stuurprogramma voor SQL Server het JSON-gegevenstype. Met deze functie kunnen Java-toepassingen lezen van en schrijven naar SQL Server-kolommen van het type json, waardoor naadloze interactie met semi-gestructureerde gegevens mogelijk is.

Hieronder volgen voorbeelden van manieren om te communiceren met JSON-gegevenstypen met behulp van het JDBC-stuurprogramma.

JSON-gegevens uit een tabel vullen en ophalen

Als u wilt werken met JSON-gegevens in SQL Server, begint u met het maken van een tabel met een kolom van het type json:

CREATE TABLE sampleTable (data JSON);

JSON invoegen met een instructie:

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

Voeg JSON in met een voorbereide instructie en parameters:

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();
}

JSON-gegevens uit de tabel lezen:

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);
    }
}

JSON uitvoeren vanuit een opgeslagen procedure

In het volgende voorbeeld ziet u hoe u een json-uitvoerparameter kunt retourneren uit een opgeslagen procedure.

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

Haal de JSON-uitvoer op door de parameter te registreren en de procedure uit te voeren.

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);
}

Parameters met tabelwaarde (TVP's) met JSON

In dit voorbeeld worden JSON-gegevens ingevoegd met een 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();
}

SQLServerBulkCopy van brontabel naar doeltabel gebruiken met JSON

SQLServerBulkCopy wordt gebruikt voor het kopiëren van gegevens uit een brontabel met JSON-kolommen in een doeltabel.

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"));
}

Bulkkopie gebruiken met JSON-kolom uit CSV

Kopieer en plak de volgende tekst in een CSV-bestand met de naam json.csv:

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

Gebruik bulksgewijs kopiëren om de CSV-gegevens in een tabel in te voegen:

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);
}

Beperkingen van JSON

Zie beperkingen voor JSON-gegevenstypen voor gedetailleerde beperkingen.

Verwante inhoud

• Informatie over de gegevenstypen van het JDBC-stuurprogramma