Przejdź do głównej zawartości

Importuje wynik zapytania SQL do zewnętrznej bazy danych do tabeli projektu PlaidCloud. Zapytanie jest wykonywane w zdalnej bazie danych; do PlaidCloud trafia tylko zbiór wyników.

Różni się od Importuj zewnętrzne tabele bazy danych tym, że SQL piszesz samodzielnie — przydatne w przypadku złożonych złączeń, filtrów lub agregacji, które chcesz, aby baza źródłowa wykonała, zanim dane trafią do PlaidCloud.

Importuj tabelę SQL


Aby utworzyć Połączenie z bazą danych, zobacz Połączenia danych PlaidCloud

Tabela docelowa

Wybór celu importu jest ograniczony wyłącznie do tabel, ponieważ widoki nie zawierają danych źródłowych.

Opcja dynamiczna

Opcja dynamiczna umożliwia określenie tabeli za pomocą tekstu, w tym zmiennych. Jest to przydatne w przepływach pracy sterowanych zmiennymi, w których odwołania do tabel i widoków zależą od określonych zmiennych.

Przykład użycia zmiennej current_month do dynamicznego wskazania tabeli docelowej:

legal_entity/inputs/{current_month}/ledger_values

Opcja statyczna

Jeśli jako cel importu ma służyć konkretna tabela, pozostaw niezaznaczone pole Dynamiczna i wybierz tabelę docelową.

Jeśli tabela docelowa nie istnieje, wybierz przycisk Utwórz nową tabelę, aby utworzyć tabelę w wybranej lokalizacji.

Funkcja Eksplorator tabel jest zawsze dostępna przy wyborze dowolnej tabeli. Kliknij przycisk Eksplorator tabel po prawej stronie wyboru tabeli, a otworzy się okno Eksploratora tabel.

W tej sekcji napisz zapytanie SQL zwracające wymagane dane.

Podgląd

Kliknij Podgląd na karcie Źródło, aby zobaczyć do 100 wierszy tego, co krok odczytałby, bez jego uruchamiania. Jeśli wynik jest dłuższy, podgląd informuje, że pokazuje pierwsze wiersze i że aby odczytać wszystkie, trzeba uruchomić krok.

Podgląd podstawia zmienne projektu i przepływu pracy tak samo jak uruchomienie. Nie obsługuje formatów zmiennych, takich jak {x:>9}, i nie potrafi podstawić zmiennej, która ma wartość tylko podczas uruchomienia, na przykład wartości wyzwalacza.

Podgląd tylko odczytuje dane. Odrzuca zapytanie, które mogłoby cokolwiek zmienić, i zamiast wierszy pokazuje komunikat:

  • Preview only supports standard SQL functions. Run the step to see results. Zapytanie używa funkcji, której Podgląd nie może sprawdzić jako tylko do odczytu. Uruchom krok, aby zobaczyć wynik.
  • Zapytanie, które nie jest pojedynczym SELECT albo którego zmienne rozwijają się do instrukcji zapisującej, jest odrzucane.

Podgląd nie jest dostępny w zablokowanym projekcie, w połączeniach SQL Server, Oracle ani SQLite, ani w krokach uruchamianych przez agenta, takich jak krok Agent Remote Execution of SQL.

Importy SQL mogą próbować odgadnąć typ danych podczas ładowania lub ustawić wszystkie kolumny na typ Tekst. Dynamiczne ustawianie typów danych może być szybsze, jeśli dane są czyste, ale w niektórych okolicznościach może powodować problemy.

Na przykład, jeśli większość danych wygląda na liczbowe, ale zawierają one także tekst, może spróbować ustawić typ liczbowy, powodując problemy z ładowaniem z powodu niezgodnych typów danych. Problemy mogą wystąpić także wtedy, gdy na przykład istnieje liczbowy kod produktu o 16 cyfrach. Zostałyby obcięte początkowe zera, w wyniku czego otrzymano by liczbę zamiast 16-cyfrowego kodu.

Ustawienie wszystkich danych na tekst wymaga jednak późniejszego kroku Extract, który przekonwertuje wszystkie dane niebędące tekstem na odpowiedni typ, taki jak daty lub wartości liczbowe.


Objaw Prawdopodobna przyczyna
Krok trwał zauważalnie dłużej niż zwykle — nawet około pół godziny dłużej — bez żadnej zmiany w zapytaniu, połączeniu ani wolumenie danych Proces roboczy w tle uruchamiający import został przerwany w połowie (restart lub wywłaszczenie po stronie platformy, nie coś w Twoim przepływie pracy), a platforma ponowiła import tabeli za Ciebie. Ponowienie startuje dopiero po wykryciu przerwania, co tłumaczy dodatkowy czas.
Krok mimo tego opóźnienia zakończył się powodzeniem Ponowienie w całości zastępuje zawartość tabeli, więc wynik jest taki sam jak przy jednym czystym uruchomieniu — nie ma nic więcej do sprawdzenia ani powtórzenia.
Krok kończy się błędem „została już podjęta i nie można jej bezpiecznie uruchomić ponownie” W przypadku kroku Importuj SQL to odrzucenie już się nie zdarza — przerwanie w trakcie uruchomienia jest ponawiane. Nadal będzie ono widoczne, z założenia, przy przywracaniu archiwum projektu lub ładowaniu wymiaru, gdzie ponowne uruchomienie utworzyłoby duplikat zamiast cokolwiek zastąpić. Jeśli widzisz je w samym kroku Importuj SQL, skontaktuj się z pomocą techniczną.