Renombrar objetos en una Metric View

2026-09-14
Greg Baldini

Applies to:

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

❌ ~~Business~~

✔ Enterprise

Este procedimiento muestra cómo cambiar el nombre de un campo de una vista de métricas. El mismo patrón se aplica a todas las colecciones de una vista de métricas: Fields, Measures, Dimensions y Joins.

Note

Estos procedimientos están dirigidos a Tabular Editor 3.26.2 y versiones posteriores. Las versiones anteriores no admiten las funcionalidades de la vista de métricas v1.1 que se muestran aquí.

Carga la Metric View de ejemplo para estos fragmentos de código

Antes de empezar, asegúrate de tener Tabular Editor 3 abierto 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 uno de los métodos siguientes para cargarla ("descargar y cargar" o "copiar y deserializar"); después, sigue con el resto de esta guía. Puedes ejecutar cualquiera de los comandos en el mismo C# Script que el resto de este ejemplo, o bien ejecutarlo primero en un C# Script independiente y luego 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 ejecute. Con la ejecución de scripts activada, 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

Descargar sample-metricview.yaml y cárgalo usando 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)

Cambiar el nombre de un campo

Asigna la propiedad Name del objeto. Todo lo demás del objeto (su expresión, comentario, nombre para mostrar, sinónimos y formato) se mantiene sin cambios, y conserva su lugar en la colección.

var view = SemanticBridge.MetricView.Model;

view.Fields["order_month"].Name = "Order Month";

var sb = new System.Text.StringBuilder();
sb.AppendLine("Fields:");
foreach (var field in view.Fields)
{
    sb.AppendLine($"  {field.Name}");
}
Output(sb.ToString());

Salida:

Fields:
  product_name
  product_category
  customer_segment
  order_date
  order_year
  Order Month

El índice de nombres de la colección se actualiza con el objeto, de modo que se puede acceder al campo de inmediato con su nuevo nombre:

var field = view.Fields["Order Month"];

Reglas

Los nombres deben ser únicos dentro de su colección. Si cambias el nombre de un campo por uno que ya usa otro campo, se produce una ArgumentException y no se modifica ni el objeto ni la colección.
La coincidencia de nombres no distingue entre mayúsculas y minúsculas, de acuerdo con Databricks SQL. view.Fields["ORDER MONTH"] encuentra el campo cuyo nombre se cambió anteriormente. Aunque un cambio de nombre solo modifique las mayúsculas y minúsculas, sigue siendo útil, ya que actualiza el nombre almacenado.
El cambio de nombre se aplica al modelo de objetos en memoria. Serializa la vista para escribirla.

Pasos a seguir

Ver también

Modelo de objetos de la Metric View
@validación de Metric View en Semantic Bridge