Zapytania do danych Azure Databricks w Arkuszach Google

Złącze Databricks dla Google Sheets zapytuje dane z twojej przestrzeni roboczej Azure Databricks i importuje je do Google Sheets. Możesz wybierać tabele bezpośrednio, pisać zapytania SQL, dodawać parametry, tworzyć tabele przestawne i importować z szablonów. Łącznik automatycznie zapisuje wszystkie zapytania jako import, dzięki czemu można odświeżyć wyniki i ponownie użyć istniejących zapytań.

Wymagania wstępne

• Skonfigurowaliśmy łącznik usługi Databricks dla arkuszy Google.

Wybieranie metody importowania

Możesz importować dane z Azure Databricks do Google Sheets, wybierając tabelę, pisząc zapytanie SQL lub korzystając z szablonu. Po zaimportowaniu danych zapytanie jest powiązane z arkuszem. Łącznik obsługuje importowanie do limitu 10 milionów komórek, który obowiązuje w arkuszach Google.

Zmiana nazwy arkusza powoduje przerwanie mapowania. Aby uzyskać informacje na temat obsługi zmian nazw, zobacz Ograniczenia.

Wybierz metodę importu, aby rozpocząć:

Wybieranie danych

Aby zaimportować dane z tabeli w Azure Databricks, wykonaj następujące czynności:

1. Na okienku bocznym Łącznik Databricks dla Arkuszy Google w sekcji Nowy import dla Metoda importu wybierz opcję Wybierz dane.
2. W obszarze Wykaz użyj menu rozwijanych wykazu, schematu i tabeli, aby wyszukać tabelę, którą chcesz zaimportować.
3. Opcjonalnie zaktualizuj nazwę zasobu , aby zmienić nazwę tego importu.
4. Opcjonalnie w obszarze Pola wybierz kolumny do uwzględnienia lub wykluczenia.
5. Opcjonalnie możesz zaimportować jako tabelę przestawną.
6. Aby dodać filtr, kliknij pozycję + Filtr w obszarze Filtry. Wybierz kolumnę, do której zostanie zastosowany filtr, oraz typ filtru.
7. Opcjonalnie włącz opcję Ogranicz wiersze , aby ustawić limit liczby wierszy do zaimportowania. Limit jest domyślnie włączony i ustawiony na 1000 wierszy.
8. W obszarze Miejsce docelowe danych wyjściowych wybierz, czy chcesz zapisać wyniki zapytania w nowym arkuszu, czy w bieżącym arkuszu.
   • Jeśli wybierzesz nowy arkusz, wprowadź nazwę arkusza.
   • Jeśli wybierzesz bieżący arkusz, określ komórkę, w której chcesz rozpocząć dodawanie danych.
9. Kliknij pozycję Zapisz i importuj , aby wypełnić arkusz.

Pisanie zapytania SQL

Aby napisać nowe zapytanie SQL, wykonaj następujące czynności:

1. Na pasku bocznym Łącznik Databricks dla Arkuszy Google w obszarze Nowy import wybierz pozycję Napisz SQL.
2. Usługa Databricks zaleca wprowadzenie nazwy zapytania, aby było możliwe do zidentyfikowania.
3. Możesz przeglądać wykazy, schematy i tabele.
4. W edytorze SQL wpisz swoje zapytanie SQL. Aby napisać dłuższe zapytanie w większym oknie lub podglądać wyniki przed importem, rozwiń edytor SQL.
5. Opcjonalnie możesz dodać parametry zapytania.
6. W obszarze Miejsce docelowe danych wyjściowych wybierz, czy chcesz zapisać wyniki zapytania w nowym arkuszu, czy w bieżącym arkuszu.
   • Jeśli wybierzesz nowy arkusz, wprowadź nazwę arkusza.
   • Jeśli wybierzesz bieżący arkusz, określ komórkę, w której chcesz rozpocząć dodawanie danych.
7. Kliknij pozycję Zapisz i importuj , aby uruchomić zapytanie i wypełnić arkusz.

Użyj szablonu

Administrator przestrzeni roboczej lub użytkownik z uprawnieniami CREATE CATALOG musi skonfigurować szablony, zanim będzie można zaimportować jeden z nich. Aby zaimportować z szablonu, wykonaj następujące czynności:

1. W pasku bocznym Databricks Connector Google Sheets, w sekcji Nowy import, dla metody importu, wybierz Użyj szablonu.
2. Wybierz grupę szablonów, a następnie szablon. Podgląd wyświetla importy szablonu.
3. Wybierz importy, które chcesz zaimportować. Wszystkie importy są wybierane domyślnie.
4. Kliknij Importuj szablony. Każdy wybrany import jest dodawany do nowego arkusza i zachowuje się jak każdy inny zapisany import.

Dodawanie parametrów zapytania (opcjonalnie)

Aby dodać parametry zapytania do zapytania SQL:

1. Upewnij się, że zapytanie ma co najmniej jeden parametr zapytania w formacie :parameter_name. Aby uzyskać więcej informacji na temat parametrów zapytania, zobacz Używanie nazwanych znaczników parametrów.

2. Kliknij + Dodaj parametr.

3. Wprowadź parametr w pierwszym polu. Upewnij się, że nazwa parametru jest zgodna z tym, co wprowadzono w edytorze zapytań.

4. Wpisz nazwę arkusza i lokalizację komórki, w której znajduje się wartość parametru, w drugim polu, łącznie z wykrzyknikiem po nazwie arkusza.

5. Aby dodać więcej parametrów zapytania, kliknij ponownie pozycję + Dodaj parametr .

   Na przykład następujące zapytanie zawiera parametr zapytania :trip_distance, który jest zdefiniowany w arkuszu sheet_1 w komórce H1.

   

Rozwiń edytor SQL (opcjonalnie)

Databricks Connector dla Google Sheets może otworzyć edytor Write SQL w osobnym, większym oknie, dzięki czemu możesz pisać, parametryzować i podglądać dłuższe zapytania niż mieszczące się w pasku bocznym. Arkusz kalkulacyjny pozostaje użyteczny, gdy okno jest otwarte.

Aby rozszerzyć edytor SQL:

1. W formularzu Write SQL kliknij ikonę rozwijania obok etykiety edytora SQL .

   Edytor SQL otwiera się w nowym oknie. Gdy jest otwarty, pasek boczny pokazuje, że edytor zapytań jest rozwinięty i nie można edytować zapytania w pasku bocznym.

2. Edytuj swoje zapytanie SQL. Aby dodać parametry zapytania, kliknij + Dodaj parametr. Parametry działają tak samo jak w pasku bocznym. Zobacz Dodawanie parametrów zapytania.

3. Aby sprawdzić zapytanie przed importem, kliknij Podgląd. Okno pokazuje łączną liczbę wierszy, które zwraca zapytanie, oraz pierwsze 10 wierszy.

4. Wybierz sposób zamknięcia okna:

   • Aby zachować zmiany, kliknij Zapisz. Możesz też kliknąć Zwiń w pasku bocznym.
   • Aby odrzucić zmiany, kliknij Anuluj lub zamknij okno. Jeśli masz niezapisane zmiany, przeglądarka prosi o potwierdzenie przed zamknięciem okna.

Importuj jako tabela przestawna (opcjonalnie)

Aby zaimportować dane jako tabelę przestawną, wykonaj następujące czynności:

1. Aby zaimportować dane przy użyciu metody Wybierz dane , zaznacz pole wyboru Tabela przestawna .
2. W obszarze Konfiguracja tabeli przestawnej wybierz wiersze i kolumny dla wymiarów tabeli przestawnej.
3. Określ wartości do agregowania według. Kliknij pozycję + Dodaj wartość i wybierz kolumnę i metodę agregacji.
4. Opcjonalnie dodaj filtry, klikając pozycję + Dodaj filtr , a następnie wybierz typ Kolumna i Filtr.
5. Kliknij pozycję Zapisz i importuj , aby zaimportować wyniki jako tabelę przestawną. Tabele przestawne są automatycznie importowane do nowego arkusza.

Pola obliczane

Obliczone pole to kolumna wyprowadzona z istniejących danych, takich jak profit obliczona z revenue i cost. Konektor Databricks dla Google Sheets nie obsługuje tworzenia pól obliczeniowych przy użyciu metody importu Select data. Aby dodać pole obliczeniowe, użyj jednej z następujących metod:

• Write SQL: Użyj metody importu Write SQL , aby obliczyć obliczone kolumny dowolnym wyrażeniem SQL. Zobacz Wybierz metodę importu.
• Genie One: Poproś Genie One o zwrócenie danych z potrzebnymi kolumnami obliczeniowymi, a następnie zaimportuj wyniki. Zobacz Użyj Genie One w Google Sheets.

Databricks zaleca korzystanie z Genie One w przypadku pól obliczeniowych.

Zarządzanie zaimportowanymi danymi

Aby zarządzać danymi importowanych z Azure Databricks, wykonaj następujące czynności:

1. Kliknij kartę Zapisane importy na pasku bocznym łącznika.

2. Aby ręcznie odświeżyć zaimportowane dane:

   • Odśwież pojedynczy import: kliknij ikonę odświeżania obok nazwy zapytania.
   • Odśwież wszystkie importy: kliknij ikonę odświeżania w górnej części karty Zapisane importy obok ikony kalendarza.

   Aby automatycznie odświeżyć importy zgodnie z harmonogramem cyklicznym, zobacz Planowanie odświeżania danych w arkuszach Google.

3. Aby zobaczyć, z którym arkuszem jest połączony import, kliknij > Przejdź do pozycji Arkusz obok nazwy zapytania.

4. Aby edytować import, kliknij > Edytuj obok nazwy zapytania.

5. Aby usunąć import, kliknij > Usuń obok nazwy zapytania. Spowoduje to usunięcie zapytania, a nie danych zaimportowanych do arkuszy Google. Musisz ręcznie usunąć zaimportowane dane.

Implikacje dotyczące udostępniania

Dodatek nie ma wpływu na możliwość udostępniania arkusza Google. Jednak sposób udostępniania pliku ma wpływ na akcje, które odbiorcy mogą wykonać przy użyciu dodatku.

• Adresaci z rolą Osoba przeglądająca lub Komentator nie mogą uzyskać dostępu do dodatku.
• Adresaci z rolą Edytora i równoważnym dostępem do zasobów danych mogą używać dodatku do konta Google. Mogą używać łącznika tak samo jak właściciel.
• Adresaci z rolą Edytora i tym samym dostępem do zasobów podstawowych mogą aktualizować importy, jeśli są zalogowani do tego samego obszaru roboczego Azure Databricks.

Przenoszenie zaimportowanych danych

Przenieś zaimportowane tabele przy użyciu standardowych poleceń kopiowania i wklejania lub wycinania i wklejania:

• Kopiowanie i wklejanie powiela dane tabeli.
• Wytnij i wklej przenosi zaimportowaną tabelę.

Azure Databricks nie uniemożliwia eksportowania danych tabeli.

Ograniczenia

• Zmiana nazwy lub usunięcie arkusza dołączonego do istniejącego importu uniemożliwia odświeżenie importu. Aby rozwiązać ten problem, wykonaj jedną z następujących czynności:

  • Utwórz ponownie arkusz o tej samej nazwie.
  • Utwórz nowy import, wybierając pozycję Wybierz zapytanie jako źródło, ponownie używając importu, a następnie klikając pozycję Zapisz jako nowy.

• Jeśli dwa zapytania są mapowane na te same lub nakładające się zakresy, dodatek wyświetla wyniki ostatnio wykonanego zapytania. Spowoduje to zastąpienie wcześniej zaimportowanych danych.

• Gdy importujesz szablon, zapytanie, którego parametr wskazuje na komórkę, nie jest uruchamiane automatycznie. Connector zapisuje zapytanie i prosi o skonfigurowanie parametru przed jego uruchomieniem. Zobacz szablony w Arkuszach Google.

Następne kroki

• Planowanie odświeżania danych w arkuszach Google