Bagikan melalui

Bekerja dengan metadata tampilan metrik menggunakan Driver Databricks JDBC

Driver Databricks JDBC mendukung operasi metadata yang ditingkatkan yang memungkinkan alat dan aplikasi kecerdasan bisnis (BI) menemukan tampilan metrik dan mengidentifikasi kolom pengukuran di dalamnya menggunakan metode metadata JDBC standar.

Alat BI dapat memfilter dan menampilkan tampilan metrik secara terpisah di browser sumber data, menghasilkan SQL yang sesuai dengan membedakan langkah-langkah dari dimensi, dan membangun kemampuan lapisan semantik yang kaya. Alat eksplorasi data dapat membantu pengguna menemukan dan memahami metrik bisnis yang tersedia di seluruh katalog Anda.

Aktifkan metadata yang disempurnakan

Metadata yang ditingkatkan untuk tampilan metrik dinonaktifkan secara default untuk mempertahankan kompatibilitas mundur. Aktifkan menggunakan properti koneksi JDBC atau pengaturan konfigurasi Spark SQL.

Atur EnableMetricViewMetadata properti koneksi ke 1 saat membuat koneksi JDBC.

Menggunakan properti koneksi

Properties properties = new Properties();
properties.setProperty("UID", "<username>");
properties.setProperty("PWD", "<password>");
properties.setProperty("EnableMetricViewMetadata", "1");

String url = "jdbc:databricks://<workspace-host>:443/default;httpPath=<http-path>";
Connection connection = DriverManager.getConnection(url, properties);

Menggunakan parameter URL JDBC

String url = "jdbc:databricks://<workspace-host>:443/default;" +
             "httpPath=<http-path>;" +
             "EnableMetricViewMetadata=1";
Connection connection = DriverManager.getConnection(url, properties);

Atau, atur spark.databricks.metadata.metricview.enabled ke 1 dalam sesi SQL Anda:

Connection connection = DriverManager.getConnection(url, properties);
Statement statement = connection.createStatement();
statement.execute("SET spark.databricks.metadata.metricview.enabled=1");
// Metadata operations now return enhanced metric view information

Mengidentifikasi tampilan metrik

DatabaseMetaData.getTables() Gunakan metode untuk menemukan tampilan metrik. Dengan mengaktifkan metadata yang ditingkatkan, metode ini mengembalikan METRIC_VIEW sebagai TABLE_TYPE untuk tampilan metrik, sehingga Anda dapat membedakannya dari tampilan dan tabel reguler.

Connection connection = DriverManager.getConnection(url, properties);
DatabaseMetaData metadata = connection.getMetaData();
ResultSet tables = metadata.getTables(catalog, schema, "<metric_view>", null);

while (tables.next()) {
    String tableName = tables.getString("TABLE_NAME");
    String tableType = tables.getString("TABLE_TYPE"); // Returns "METRIC_VIEW"
    System.out.println("Metric View: " + tableName);
}

Mengidentifikasi kolom pengukuran

DatabaseMetaData.getColumns() Gunakan metode untuk mengidentifikasi kolom pengukuran dalam tampilan metrik. Setelah metadata diperbarui diaktifkan, kolom TYPE_NAME mengembalikan <data_type> measure untuk kolom pengukuran (misalnya, int measure, double measure).

Connection connection = DriverManager.getConnection(url, properties);
DatabaseMetaData metadata = connection.getMetaData();
ResultSet columns = metadata.getColumns(catalog, schema, metricViewName, "%");

while (columns.next()) {
    String columnName = columns.getString("COLUMN_NAME");
    String typeName = columns.getString("TYPE_NAME");

    if (typeName.endsWith(" measure")) {
        System.out.println("Measure column: " + columnName + " (" + typeName + ")");
    } else {
        System.out.println("Dimension column: " + columnName + " (" + typeName + ")");
    }
}

Filter menurut jenis tabel

DatabaseMetaData.getTableTypes() Gunakan metode untuk menemukan jenis tabel yang tersedia di katalog Anda. Dengan mengaktifkan metadata yang disempurnakan, metode ini mencakup METRIC_VIEW dalam daftar jenis tabel yang tersedia.

Connection connection = DriverManager.getConnection(url, properties);
DatabaseMetaData metadata = connection.getMetaData();
ResultSet tableTypes = metadata.getTableTypes();

while (tableTypes.next()) {
    String tableType = tableTypes.getString("TABLE_TYPE");
    System.out.println("Available table type: " + tableType);
    // Output includes: TABLE, VIEW, METRIC_VIEW, ...
}

Kompatibilitas ke belakang

Secara default, EnableMetricViewMetadata diatur ke 0 untuk mempertahankan kompatibilitas mundur dengan aplikasi yang ada. Azure Databricks mengembalikan tampilan metrik sebagai tipe reguler VIEW, dan kolom ukuran menampilkan jenis data dasarnya tanpa akhiran measure.

Langkah selanjutnya

  • Last updated on