Przejdź do treści
Biblioteka skilli
Dane i analityka · Budowanie i kod

lookml-explore

/lookml-explore

Tworzy i zmienia Explore w LookML: definicję Explore, joiny, grupy dostępu i podstawową konfigurację.

Repozytorium
looker-skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
15.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 15.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Tworzy i zmienia Explore w LookML: definicję Explore, joiny, grupy dostępu i podstawową konfigurację.

Oryginalny opis (EN)

Use this skill when you need to create or modify a LookML Explore. This includes defining the Explore, joins, access grants, and basic configuration.

Jak działa

  1. 1. Core Standards
  2. 2. Advanced Configuration
  3. 3. Performance Optimization (Aggregate Tables)
  4. 4. Extending Explores
  5. Basic Explore
  6. Explore with Filters & Caching
  7. Reference Skills
Sekcje z nagłówków SKILL.md, w oryginale · 154 linii, 644 słów
Podgląd SKILL.md
---
name: lookml-explore
description: Use this skill when you need to create or modify a LookML Explore. This includes defining the Explore, joins, access grants, and basic configuration.
license: Apache-2.0
metadata:
  publisher: google
  version: v1
---

# Instructions

## 1. Core Standards

1.  **Naming Convention**: `snake_case` for the Explore name.
2.  **Required Parameters**:
    -   `description`: **100% Coverage**. Every Explore MUST have a description.
    -   `label`: A user-friendly name for the Explore in the UI.
    -   `view_name`: Defaults to explore name, but explicit definition is safer.
3.  **Joins**:
    -   `relationship`: **Required** (one_to_one, many_to_one).
    -   `sql_on`: **Required**. Use `${left.id} = ${right.id}` syntax.
    -   `type`: defaults to `left_outer`. Use `inner` or `full_outer` explicitly if needed.
4.  **Formatting**:
    -   Do NOT use `from` to rename views just for aesthetics. Use `view_label` instead.
    -   Exception: Polymorphic joins, Self-joins, Rescoping extensions.

## 2. Advanced Configuration

-   `always_filter`: specific filters that users can change but cannot remove.
-   `sql_always_where`: specific restrictions that users _cannot_ change.
-   `persist_with`: Link explore cache to datagroups (e.g., `default_datagroup`).
-   `fields`: Use inclusive lists to strictly control content when necessary (`ALL_FIELDS*`, `-view.field`).

## 3. Performance Optimization (Aggregate Tables)

Aggregate Tables (Aggregate Awareness) allow Looker to query smaller, pre-aggregated tables instead of the raw granular data, drastically improving query performance.

### Anatomy of an Aggregate Table

```lookml
explore: orders {
  aggregate_table: rollup_name {
    query: {
      dimensions: [created_date, status]
      measures: [total_revenue, count]
      filters: [orders.created_date: "6 months"]
    }
    materialization: {
      datagroup_trigger: ecommerce_etl
      # partition_keys: ["created_date"] # BigQuery/Presto optimization
      # increment_key: "created_date"    # Incremental builds
      # increment_offset: 3              # Rebuild last 3 periods
    }
  }
}
```

### Key Parameters

1.  **Query**: Defines the "shape" of the rollup.
    *   **Dimensions**: Include all dimensions commonly used in dashboards (including filters).
    *   **Measures**: Include base measures (sum, count). Looker can derive averages from sum+count.
    *   **Filters**: Optional. Restricts the rollup to a subset of data (e.g., "last 6 months").

2.  **Materialization**:
    *   **datagroup_trigger**: (Recommended) Rebuilds when the ETL job completes.
    *   **sql_trigger_value**: Rebuilds when a SQL query returns a new value.
    *   **increment_key**: (Advanced) Appends new data instead of full rebuilds. Best for massive tables.
    *   **indexes** / **partition_keys** / **cluster_keys**: Dialect-specific optimizations.

3.  **Best Practices**:
    *   **Timeframes**: Include the finest grain needed (e.g., `date`). Looker can roll up `date` to `month` or `year` automatically.
    *   **Exact Match**: The user's query must be a *strict subset* of the aggregate table's fields to satisfy the awareness logic.
    *   **Filter Awareness**: If a user filters on a field *not* in the aggregate table, Looker cannot use it (unless it's an "exact match" special case). Add common filter fields to the `dimensions` list.

## 4. Extending Explores

*   **Extends**: Use `extends: [base_explore]` to inherit joins, fields, and descriptions from another explore.
    *   **Use Case**: Create a "Base" explore with common joins, then "Extended" explores for specific analysis (e.g., `orders` -> `marketing_orders`).

# Examples

## Basic Explore

```lookml
explore: orders {
  label: "Orders"
  description: "Analyze order data, including user and product details."
  view_name: orders
  
  join: users {
    relationship: many_to_one
    sql_on: ${orders.user_id} = ${users.id} ;;
  }
}
```

## Explore with Filters & Caching

```lookml
explore: events {
  label: "Web Events"
  description: "User interaction events."
  persist_with: default_datagroup

  # Users can change this filter, but it defaults to '7 days'
  always_filter: {
    filters: [events.created_date: "7 days"]
  }

  # Users CANNOT change this filter.
  sql_always_where: ${events.is_test_data} = false ;;
  
  join: sessions {
    relationship: many_to_one
    sql_on: ${events.session_id} = ${sessions.session_id} ;;
  }
}

## Aggregate Table (Advanced)

```lookml
explore: orders {
  aggregate_table: monthly_sales_summary {
    query: {
      dimensions: [created_month, status, products.category]
      measures: [total_revenue, count]
      filters: [orders.created_date: "2 years"]
    }
    materialization: {
      datagroup_trigger: ecommerce_etl
      partition_keys: ["created_month"]
      increment_key: "created_month"
      increment_offset: 1 # Rebuild current and previous month
    }
  }
}
```

## Extended Explore

```lookml
explore: orders_extended {
  extends: [orders]
  label: "Orders (Marketing View)"
  view_name: orders
  
  # Add new joins specific to this view
  join: marketing_channels {
    sql_on: ${orders.channel_id} = ${marketing_channels.id} ;;
    relationship: many_to_one
  }
}
```
```

## Reference Skills

For more complex scenarios, refer to these specialized skills:
- [Advanced Explore Configuration](references/advanced.md): UNNESTing, lateral flattens, and row-level security.
- [Joins Deep Dive](references/joins.md): Detailed join types, relationships, and aliasing.
Pliki w paczce (3)
  • SKILL.md 5 KB
  • references/advanced.md 1 KB
  • references/joins.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie lookml-explore.

Migawka bazy z 13.11.2026 · wersja paczki ac236a977bff (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100lookml-view
    Tworzy i zmienia widoki LookML: podstawowe definicje, sql_table_name, organizację plików i wzorce.
  • 100lookml-model
    Tworzy i zmienia pliki modelu LookML (.model.lkml): definiuje połączenia, includes i ustawienia na poziomie modelu.
  • 100looker-expert
    Wspiera pracę z Looker BI i LookML: eksploracje, wymiary, miary, dashboardy, trwałe tabele pochodne, łączenia i modelowanie danych.
  • 100droughty
    Obsługuje zestaw Droughty do introspekcji schematów: konfiguracja profilu i projektu, generowanie LookML z hurtowni, testy dbt, diagramy DBML, dokumentacja pól i raporty jakości danych.
  • 100semantic-layer-bootstrap
    Tworzy lub porządkuje warstwę semantyczną Motley z surowej bazy, metadanych BI, dbt, LookML lub Cube, a także z pytań.
  • 100modeler
    Buduje, waliduje i zarządza modelami semantycznymi w Sidemantic: warstwa semantyczna, metryki i wymiary, modele ze schematu bazy lub zapytań SQL oraz import z Cube, dbt i LookML, głównie przez CLI i YAML.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.