Table of Contents

Gestionar errores comunes

  • 2026-07-02
  • Greg Baldini
Applies to:
  • ❌ Tabular Editor 2
  • Tabular Editor 3 (Available since 3.25.0)
    ❌ Desktop
    ❌ Business
    ✔ Enterprise

Este procedimiento muestra cómo gestionar varios fallos comunes al trabajar con Metric Views en C# Scripts: YAML no válido, archivos faltantes, operaciones sin ninguna Metric View cargada y una importación que no llega a completarse.

Note

Estas guías prácticas están pensadas para Tabular Editor 3.26.2 y versiones posteriores. Las versiones anteriores no admiten las características de Metric View v1.1 que se muestran aquí.

Fallo al cargar o deserializar

Load y Deserialize lanzan System.IO.InvalidDataException cuando la entrada no representa un YAML de Metric View válido. La excepción, por sí sola, solo indica que la carga falló; los motivos concretos se recogen en ImportDiagnostics. Si se produce un error, el Metric View actual (SemanticBridge.MetricView.Model) se establece en null.

try
{
    // This Metric View is missing the required `source`, so it fails to deserialize.
    SemanticBridge.MetricView.Deserialize("""
        version: 1.1
        fields:
          - name: revenue
            expr: source.revenue
        """);
}
catch (System.IO.InvalidDataException)
{
    var sb = new System.Text.StringBuilder();
    sb.AppendLine("Could not load the Metric View:");
    foreach (var diag in SemanticBridge.MetricView.ImportDiagnostics)
    {
        sb.AppendLine($"  [{diag.Severity}] {diag.Code}: {diag.Message}");
    }
    Output(sb.ToString());
}

Salida

Could not load the Metric View:
  [Error] VIEW_SOURCE_REQUIRED: View source cannot be empty
Note

Load lee desde una ruta de archivo, por lo que una ruta que no existe lanza System.IO.FileNotFoundException en lugar de InvalidDataException. Captura esa excepción (o una System.Exception más general) al cargar desde una ruta.

Comprobar que hay una Metric View cargada

Validate, Serialize, Save e ImportToTabular lanzan System.InvalidOperationException si no hay ningún Metric View cargado. Model es null cuando no hay nada cargado, así que compruébalo antes de continuar.

Ejecuta este script en una instancia nueva de Tabular Editor 3 para asegurarte de que no tienes ningún Metric View cargado:

if (SemanticBridge.MetricView.Model == null)
{
    Output("No Metric View is loaded. Load or deserialize one first.");
}
else
{
    var diagnostics = SemanticBridge.MetricView.Validate();
    Output($"Found {diagnostics.Count()} issue(s).");
}

Salida

No Metric View is loaded. Load or deserialize one first.

Sin esa comprobación, llamar a SemanticBridge.MetricView.Validate() cuando no hay nada cargado lanza InvalidOperationException.

Una importación que no se completa

ImportToTabular e ImportToTabularFromFile devuelven false cuando la importación no puede completarse, en lugar de lanzar una excepción. Comprueba el valor devuelto y lee los diagnósticos de out para ver por qué.

El ejemplo siguiente deserializa una vista de métricas válida y luego deja en blanco la expresión de un campo, lo que provoca un error de validación. Como failOnValidationErrors tiene el valor predeterminado true, la importación se detiene antes de traducir y devuelve false, con los motivos en los diagnósticos de out. Debe haber un modelo tabular abierto.

// Load a valid Metric View, then make it invalid
SemanticBridge.MetricView.Deserialize("""
    version: 1.1
    source: sales.fact.orders
    fields:
      - name: order_year
        expr: source.order_year
    measures:
      - name: total_revenue
        expr: SUM(source.revenue)
    """);

var view = SemanticBridge.MetricView.Model;
view.Fields["order_year"].Expr = ""; // an empty expression is invalid

var success = SemanticBridge.MetricView.ImportToTabular(
    Model,
    "your-workspace.azuredatabricks.net",
    "/sql/1.0/warehouses/abc123def456",
    out var diagnostics
);

var sb = new System.Text.StringBuilder();
if (success)
{
    sb.AppendLine("Import complete.");
}
else
{
    sb.AppendLine("Import did not complete:");
    foreach (var diag in diagnostics)
    {
        sb.AppendLine($"  [{diag.Severity}] {diag.Code}: {diag.Message}");
    }
}
Output(sb.ToString());

Salida

Import did not complete:
  [Error] FIELD_EXPR_REQUIRED: Field 'order_year' expr cannot be empty

Use failOnValidationErrors: false bajo su propia responsabilidad si desea importar a pesar de los problemas de validación. Si no hay ninguna vista de métricas cargada cuando se llama a este método, se lanza InvalidOperationException, como se describe arriba.

Pasos a seguir

Ver también