Firma migruje z Google Sheets do BigQuery. Zespół wchodzi do raportu Data Studio, zmienia źródło danych na nowe połączenie BigQuery i… wszystkie wykresy pokazują Configuration Error i Unknown Dimension. Tydzień pracy – w gruzach. Przyczyną jest zmiana nazw kolumn. Rozwiązanie – ekran mapowania, o którym większość nie wie.

Dlaczego wykresy padają po zmianie źródła?

Data Studio zapamiętuje wykresy nie po etykietach widocznych na ekranie, ale po identyfikatorze pola – wewnętrznej nazwie kolumny ze źródła danych. Gdy przeciągasz pole „Sprzedaż Całkowita" na wykres, raport zapisuje sobie dokładnie: Sprzedaz_Calkowita.

Gdy teraz podpinasz nowe źródło BigQuery, a inżynierowie danych nazwali tam tę samą kolumnę total_revenue – Data Studio szuka Sprzedaz_Calkowita, nie znajduje, zwraca Unknown Dimension. To nie błąd systemu – to konsekwencja zmiany nazewnictwa bez mapowania.

Poprawna procedura zmiany z Data Mapping

Nie zmieniaj źródła bezpośrednio przez kliknięcie na wykresie – to zmienia źródło tylko dla tego jednego komponentu i nie daje ekranu mapowania. Właściwa ścieżka:

  1. W edytorze raportu otwórz Zasób → Zarządzaj dodanymi źródłami danych (Resource → Manage Added Data Sources).
  2. Kliknij Edytuj przy starym źródle → następnie Edytuj konfigurację.
  3. Wybierz nową tabelę/projekt BigQuery i kliknij Reconnect.
  4. Data Studio pokaże ekran Zastosuj zmiany z listą kolumn: lewa strona = stare nazwy, prawa = nowe. Tutaj ręcznie sparuj np. Koszty_PLN → spend_pln.
  5. Potwierdź – wykresy zachowają konfigurację, filtry i style. Tylko niezamapowane pola pokażą błąd.

Kluczowe: ten ekran pojawia się tylko gdy zmieniasz źródło przez Zarządzaj źródłami, nie przez prawoklik na wykresie. Większość osób omija ten krok i traci całą konfigurację raportu.

Profilaktyka: BigQuery View jako bufor nazw

Najlepsza ochrona przed tym problemem w przyszłości: zamiast podpinać Data Studio bezpośrednio do surowej tabeli BigQuery, stwórz widok (View) z aliasami kolumn dopasowanymi do nazw używanych w raporcie:

-- BigQuery View jako warstwa buforowa
CREATE OR REPLACE VIEW `projekt.analytics.raport_sprzedaz` AS
SELECT
  transaction_date   AS data_transakcji,
  total_revenue      AS sprzedaz_calkowita,
  total_cost         AS koszty_pln,
  channel            AS kanal,
  region             AS region
FROM `projekt.raw.transactions`

Data Studio łączy się z tym widokiem. Gdy tabela surowa zmienia nazwy kolumn – wystarczy zaktualizować View, bez dotykania raportu. Zero Configuration Error, zero mapowania ręcznego.

Konwencja nazewnictwa: Single Source of Truth

Długoterminowe rozwiązanie to ustalenie konwencji nazewnictwa obowiązującej zarówno w bazie jak i w raportach. Stosowane standardy w B2B:

Zasada Przykład dobry Przykład zły
snake_case (tylko małe litery + podkreślenie) total_revenue TotalRevenue, Sprzedaż
Język angielski (niezależność od lokalizacji) order_date data_zamowienia
Sufiks dla dat i kwot revenue_pln, created_at kwota, data
Brak spacji i polskich znaków client_region Region Klienta, régión

Ustalenie tej konwencji raz – przed pierwszym raportem – sprawia, że wdrożenie Data Studio w firmie staje się odporne na rotację zespołu i zmiany bazy. Zmapowane raz nazwy nigdy się nie „gubią".

Powiązane artykuły