Agregar un objeto a una Metric View

2026-07-02
Greg Baldini

Applies to:

❌ ~~Tabular Editor 2~~
Tabular Editor 3 (Available since 3.25.0)
❌ ~~Desktop~~

❌ ~~Business~~

✔ Enterprise

En esta guía práctica se muestra cómo agregar nuevos objetos a una vista de métricas cargada y establecer sus propiedades. Este patrón se aplica a todas las colecciones de Metric View.

Note

Estas guías paso a paso están pensadas para Tabular Editor 3.26.2 y versiones posteriores. Las versiones anteriores no admiten las características de la vista de métricas v1.1 que se muestran aquí.

Carga la Metric View de ejemplo para estas muestras de código

Antes de empezar, asegúrate de tener abierto Tabular Editor 3 y de haber abierto un modelo tabular, o crea uno nuevo.

Este tutorial paso a paso utiliza una Vista de Métricas de comercio electrónico de ejemplo que representa datos de ventas, con tres tablas de dimensiones (producto, cliente y fecha) unidas a una tabla de hechos (pedidos). Usa cualquiera de los métodos siguientes para cargarla («Descargar y cargar» o «Copiar y deserializar»), y luego sigue con el resto de esta guía paso a paso. Puedes ejecutar cualquiera de los dos comandos en el mismo C# Script que el resto de este ejemplo, o puedes ejecutarlo primero en su propio C# Script y el resto del ejemplo en otro C# Script.

/* Alternativa sin JS: muestra todos los paneles de pestañas apilados para que todo el contenido siga siendo accesible cuando el script de pestañas no se ejecuta. Con los scripts habilitados, este bloque se ignora y las pestañas funcionan con normalidad. */ .tabGroup section[role="tabpanel"][hidden] { display: block !important; }

Descargar y cargar
Copiar y deserializar

Descarga sample-metricview.yaml y cárgalo indicando la ruta:

SemanticBridge.MetricView.Load("C:/path/to/sample-metricview.yaml");

Copia la definición siguiente y pásala a Deserialize como una cadena:

SemanticBridge.MetricView.Deserialize("""
    <PLACEHOLDER: copy and paste the YAML shown below, indented within the triple quotes here>
    """);

version: 0.1
source: sales.fact.orders
joins:
  - name: product
    source: sales.dim.product
    on: source.product_id = product.product_id
  - name: customer
    source: sales.dim.customer
    on: source.customer_id = customer.customer_id
  - name: date
    source: sales.dim.date
    on: source.order_date = date.date_key
dimensions:
  - name: product_name
    expr: product.product_name
  - name: product_category
    expr: product.category
  - name: customer_segment
    expr: customer.segment
  - name: order_date
    expr: date.full_date
  - name: order_year
    expr: date.year
  - name: order_month
    expr: date.month_name
measures:
  - name: total_revenue
    expr: SUM(revenue)
  - name: order_count
    expr: COUNT(order_id)
  - name: avg_order_value
    expr: AVG(revenue)
  - name: unique_customers
    expr: COUNT(DISTINCT customer_id)

Agregar un campo

Use AddField para crear y devolver un nuevo Field que pueda manipular.

var sb = new System.Text.StringBuilder();
var view = SemanticBridge.MetricView.Model;

sb.AppendLine($"Campos antes de agregar: {view.Fields.Count}");

var field = view.AddField("customer_city", "customer.city");

sb.AppendLine($"Campos después de agregar: {view.Fields.Count}");
Output(sb.ToString());

Salida

Campos antes de agregar: 6
Campos después de agregar: 7

Agregar y configurar un `Join`

AddJoin funciona de forma similar a AddField: construye el objeto, lo agrega a la vista de métricas y lo devuelve para que puedas establecer propiedades adicionales. Establece la cardinalidad con la enumeración JoinCardinality.

using MetricView = TabularEditor.SemanticBridge.Platforms.Databricks.MetricView;

var view = SemanticBridge.MetricView.Model;

// agrega un join y, a continuación, establece sus propiedades restantes
var supplier = view.AddJoin("supplier", "sales.dim.supplier");
supplier.On = "source.supplier_id = supplier.supplier_id";
supplier.Cardinality = MetricView.JoinCardinality.ManyToOne;

AddJoin también es un método en cualquier Join existente. Puede usarlo para crear joins anidados; por ejemplo, supplier.AddJoin("region", "sales.dim.region"), que modela una dimensión en copo de nieve.

Agregar y configurar una `medida`

AddMeasure funciona de forma similar a los demás métodos Add.

Algunas propiedades, como el Format de un campo o una medida, tienen sus propios tipos que debes crear para poder establecer la propiedad. Crea la variante de Format que quieras, como Format.Currency o Format.Percentage, y asígnala.

using MetricView = TabularEditor.SemanticBridge.Platforms.Databricks.MetricView;

var sb = new System.Text.StringBuilder();
var view = SemanticBridge.MetricView.Model;

// agrega una nueva medida y luego asígnale un formato de moneda
var totalCost = view.AddMeasure("total_cost", "SUM(cost)");
totalCost.Format = new MetricView.Format.Currency { CurrencyCode = "USD" };

// vuelve a leer el formato de la medida
sb.AppendLine($"{totalCost.Name} formato: {totalCost.Format}");
Output(sb.ToString());

Salida

total_cost formato: Currency { Type = Currency, DecimalPlaces = , HideGroupSeparator = , Abbreviation = , CurrencyCode = USD }

Pasos a seguir

Ver también

Modelo de objetos de la Metric View

Table of Contents