Przegląd

Zgodnie z najlepszymi praktykami dla artefaktów Chains , zaleca się wdrożenie spójnych konwencji nazewnictwa dla artefaktów Wdata - takich jak tabele i zapytania - aby ułatwić nawigację i zarządzanie. Przedstawione tutaj wytyczne mają na celu pomóc Ci w spójnym organizowaniu artefaktów od samego początku.

Tabele faktów i tabele wymiarów

Tabele faktów zazwyczaj zawierają dane, które gromadzą się w czasie, podczas gdy tabele wymiarów przechowują dodatkowe zestawy danych, które zapewniają dodatkowy kontekst danych. Nazywając oba typy tabel, weź pod uwagę następujące najlepsze praktyki:

• Konwencja nazewnictwa: Stosuj spójną konwencję nazewnictwa, która wyraźnie wskazuje cel i zawartość zarówno tabel faktów, jak i tabel wymiarów.
• Nazwy opisowe: Zastosuj nazwy opisowe do obu typów tabel, aby zapewnić ich łatwą identyfikację i zrozumiałość.
• System źródłowy: Uwzględnij w nazwie system, z którego pochodzą dane.

Przykłady:

• Tabela faktów: Trial Balance - Workday

  Opis: Przechowuje dane transakcyjne salda próbnego dla Avikro Financial, pochodzące z Workday.

• Tabela wymiarów: Chart of Accounts - Workday

  Opis: Przechowuje dane planu kont dla Avikro Financial, pochodzące z Workday.

• Tabela wymiarów: Profit Centers - SAP

  Opis: Przechowuje informacje o centrach zysków dla Avikro Financial, pochodzące z SAP.

• Tabela wymiarów: Exchange Rates - Central Bank API

  Opis: Udostępnia kursy wymiany walut dla Avikro Financial, pochodzące z interfejsu API banku centralnego.

Szablon ten zapewnia spójność konwencji nazewnictwa, przejrzystość opisu i dokładną identyfikację systemu źródłowego zarówno dla tabel faktów, jak i tabel wymiarów.

Zapytania Wdata

Definiując konwencje nazewnictwa dla zapytań, ważne jest, aby zachować standardowe podejście. Dzięki temu użytkownicy mogą łatwo zidentyfikować prawidłowe zapytanie w celu pobrania określonych danych.

• Konwencja nazewnictwa: Stosuj spójną konwencję nazewnictwa, która jasno określa cel i treść zapytania.
• Nazwy opisowe: Stosuj nazwy opisowe do zapytań, aby ułatwić ich identyfikację i zrozumienie.
• System źródłowy: Określ system pochodzenia danych.

Przykład:

• Nazwa zapytania: Extended Trial Balance - Workday - Financial Statement

  Opis: To zapytanie pobiera dane bilansu próbnego z Workday wraz z dodatkowymi zestawami danych dostosowanymi do generowania sprawozdań finansowych.

Uwaga: Ważne jest, aby unikać używania separatorów potokowych (|) w tabelach i zapytaniach. Zamiast tego użyj myślników (-), aby zapobiec potencjalnym problemom z tymi artefaktami.

Przestrzeganie tej konwencji nazewnictwa sprawi również, że będzie jasne, którego zapytania należy użyć podczas tworzenia połączenia przychodzącego do arkusza kalkulacyjnego.

Opisy

Opisy są często najczęściej pomijaną częścią procesu projektowania i tworzenia, ale mają kluczowe znaczenie dla poprawy zrozumienia i użyteczności. Opisy powinny zapewniać dodatkowy kontekst, taki jak

• Wskazuje, czy tabela lub zapytanie jest symbolem zastępczym.
• Zwróć uwagę, czy zapytanie wymaga edycji przed użyciem.
• Wyjaśnienie konkretnej funkcji artefaktu, takiego jak zapytanie, np. identyfikacja płatności, które są o mniej niż 20% niższe niż w poprzednim okresie.

Dzięki jasnym i szczegółowym opisom użytkownicy mogą szybko zrozumieć cel i zawartość każdego artefaktu, zmniejszając zamieszanie, minimalizując błędy i zwiększając ogólną wydajność zarządzania środowiskiem Wdata.

Folders/Environments

Podczas organizowania przestrzeni roboczej zaleca się kategoryzowanie tabel i zapytań w folderach w oparciu o ich przeznaczenie. Struktura ta umożliwia użytkownikom łatwą nawigację i określenie, które artefakty są przeznaczone do rozwoju, testowania i produkcji.

Ponieważ Wdata obecnie nie obsługuje zarządzania cyklem życia aplikacji, zaleca się dołączanie nazw do artefaktów i folderów, aby wskazać ich odpowiednie środowisko. Pomaga to w zarządzaniu cyklem życia aplikacji i pozwala uniknąć błędów lub problemów. Zwróć uwagę, że artefakty produkcyjne nie wymagają dołączania nazw.