Samouczek: dodawanie przekształcenia dla danych obszaru roboczego Azure Cosmos DB przy użyciu portalu Azure

W tym samouczku przedstawiono konfigurację przykładowej transformacji w regule zbierania danych (DCR) obszaru roboczego przy użyciu portalu Azure.

Transformacje obszaru roboczego są przechowywane razem w jednym DCR dla obszaru roboczego, który jest nazywany DCR obszaru roboczego. Każde przekształcenie jest skojarzone z określoną tabelą. Przekształcenie jest stosowane do wszystkich danych wysyłanych do tej tabeli z dowolnego przepływu pracy, który nie korzysta z wniosku zmiany dokumentu (DCR).

W tym poradniku nauczysz się, jak:

Prerequisites

Do ukończenia tego samouczka potrzebne są następujące elementy:

• Obszar roboczy usługi Log Analytics, w którym masz co najmniej prawa współautora.
• Uprawnienia do tworzenia obiektów DCR w przestrzeni roboczej.
• Tabela, która zawiera już pewne dane.
• Nie można połączyć tabeli z przekształceniem DCR obszaru roboczego.

Omówienie samouczka

W tym samouczku zmniejszysz wymagania dotyczące przestrzeni dyskowej dla tabeli CDBDataPlaneRequests, filtrując niektóre rekordy. Możesz również usunąć zawartość kolumny w trakcie analizy danych kolumny, aby przechować określoną część danych w kolumnie niestandardowej. Tabela CDBDataPlaneRequests jest tworzona podczas włączania analizy dzienników w obszarze roboczym.

W tym samouczku jest używany portal Azure, który udostępnia kreatora, który przeprowadzi Cię przez proces tworzenia transformacji czasu pozyskiwania. Po wykonaniu kroków zobaczysz, że kreator:

• Aktualizuje schemat tabeli przy użyciu innych kolumn z zapytania.
• Tworzy WorkspaceTransformation DCR i łączy go z obszarem roboczym, jeśli domyślny DCR nie jest jeszcze połączony z obszarem roboczym.
• Tworzy transformację podczas pozyskiwania danych i dodaje ją do modułu DCR.

Włącz dzienniki inspekcji zapytań

Musisz włączyć analizę dzienników dla obszaru roboczego, aby utworzyć tabelę CDBDataPlaneRequests , z którą pracujesz. Ten krok nie jest wymagany dla wszystkich przekształceń danych w czasie pobierania. Wystarczy wygenerować przykładowe dane, z którymi pracujemy.

Dodawanie przekształcenia do tabeli

Po utworzeniu tabeli możesz utworzyć dla niej przekształcenie.

1. W menu obszary robocze Log Analytics w portalu Azure wybierz pozycję Tabele. Znajdź tabelę CDBDataPlaneRequests i wybierz pozycję Utwórz przekształcenie.

   

2. Ponieważ ta transformacja jest pierwszą w obszarze roboczym, musisz utworzyć przekształcenie obszaru roboczego DCR. Jeśli tworzysz przekształcenia dla innych tabel w tym samym obszarze roboczym, są one przechowywane w tym samym DCR. Wybierz pozycję Utwórz nową regułę zbierania danych. Subskrypcja i grupa zasobów są już wypełnione dla obszaru roboczego. Wprowadź nazwę dla DCR i wybierz opcję Gotowe.

3. Wybierz pozycję Dalej , aby wyświetlić przykładowe dane z tabeli. Podczas definiowania przekształcenia wynik jest stosowany do przykładowych danych. Z tego powodu można ocenić wyniki przed zastosowaniem ich do rzeczywistych danych. Wybierz Edytor przekształceń, aby zdefiniować przekształcenie.

   

4. W edytorze przekształceń można zobaczyć przekształcenie, które jest stosowane do danych przed ich załadowaniem do tabeli. Tabela wirtualna o nazwie source reprezentuje dane przychodzące, które mają ten sam zestaw kolumn co sama tabela docelowa. Przekształcenie początkowo zawiera proste zapytanie, które zwraca tabelę source bez zmian.

5. Zmodyfikuj zapytanie w następującym przykładzie:

   source
   | where StatusCode != 200 // searching for requests that are not successful
   | project-away Type, TenantId
   

   Modyfikacja wprowadza następujące zmiany:

   • Wiersze związane z zapytaniami dotyczącymi samej tabeli CDBDataPlaneRequests zostały usunięte, aby zaoszczędzić miejsce, ponieważ te wpisy dziennika nie są przydatne.
   • Dane z TenantId kolumn i Type zostały usunięte w celu zaoszczędzenia miejsca.
   • Przekształcenia obsługują również dodawanie kolumn przy użyciu extend operatora w zapytaniu.

   Uwaga / Notatka

   Przy użyciu portalu Azure dane wyjściowe przekształcenia zainicjują zmiany w schemacie tabeli, jeśli jest to wymagane. Kolumny zostaną dodane w celu dopasowania danych wyjściowych przekształcenia, jeśli jeszcze nie istnieją. Upewnij się, że dane wyjściowe nie zawierają żadnych kolumn, których nie chcesz dodawać do tabeli. Jeśli dane wyjściowe nie zawierają kolumn, które znajdują się już w tabeli, te kolumny nie zostaną usunięte, ale dane nie zostaną dodane.

   Wszystkie kolumny niestandardowe dodane do wbudowanej tabeli muszą kończyć się ciągiem _CF. Kolumny dodane do tabeli niestandardowej nie muszą mieć tego sufiksu. Tabela niestandardowa ma nazwę, która kończy się na ._CL

6. Skopiuj zapytanie do edytora przekształceń i wybierz pozycję Uruchom , aby wyświetlić wyniki z przykładowych danych. Możesz sprawdzić, czy nowa Workspace_CF kolumna znajduje się w zapytaniu.

   

7. Wybierz pozycję Zastosuj , aby zapisać przekształcenie, a następnie wybierz przycisk Dalej , aby przejrzeć konfigurację. Wybierz Utwórz, aby zaktualizować DCR przy użyciu nowej transformacji.

   

Testowanie przekształcenia

Poczekaj około 30 minut na zastosowanie przekształcenia, a następnie przetestuj je, uruchamiając zapytanie względem tabeli. Ta transformacja ma wpływ tylko na dane wysyłane do tabeli po zastosowaniu przekształcenia.

Na potrzeby tego samouczka uruchom kilka przykładowych zapytań, aby wysłać dane do CDBDataPlaneRequests tabeli. Uwzględnij niektóre zapytania dotyczące CDBDataPlaneRequests, aby sprawdzić, czy przekształcenie filtruje te rekordy.

Troubleshooting

W tej sekcji opisano różne warunki błędu, które mogą zostać odebrane i jak je poprawić.

Funkcja IntelliSense w Log Analytics nie rozpoznaje nowych kolumn w tabeli

Aktualizacja pamięci podręcznej obsługującej funkcję IntelliSense może potrwać do 24 godzin.

Przekształcanie w kolumnie dynamicznej nie działa

Znany problem dotyczy obecnie kolumn dynamicznych. Aby tymczasowo obejść problem, należy jawnie analizować dane kolumn dynamicznych, używając parse_json(), zanim zostaną wykonywane jakiekolwiek operacje na tych danych.

Następne kroki