Zacznij od istniejącego projektu

~15 minut · skopiuj lub zaimportuj projekt, a potem uczyń go swoim

Najszybszy sukces pierwszego dnia w PlaidCloud to nie budowanie od zera — to start od czegoś, co już działa. Wybierz projekt, który już importuje dane, przekształca je i daje wynik, zrób własną kopię i zmień te części, które są Twoje.

Nie ma galerii szablonów do przeglądania. Zamiast tego masz dwa sprawdzone sposoby na rozpoczęcie od działającego projektu:

• Skopiuj projekt, który już istnieje w Twoim obszarze roboczym, do zupełnie nowego własnego projektu — Kopiowanie projektu.
• Uruchom przenośny pakiet — projekt wyeksportowany przez kogoś jako samodzielny pakiet w formacie przenośnym, który działa samodzielnie poza PlaidCloud.

To, który wybierzesz, zależy od tego, dokąd zmierzasz.

Skopiuj, aby dalej pracować w PlaidCloud; wyeksportuj przenośny pakiet, aby zabrać migawkę poza platformę.

Chcesz…	Użyj	Wynik
Rozbudować projekt w PlaidCloud i dalej go rozwijać	Kopiuj projekt	Nowy projekt, którego jesteś właścicielem, gotowy do edycji i uruchomienia
Uruchomić logikę projektu offline lub przekazać ją komuś bez loginu do PlaidCloud	Eksportuj do formatu przenośnego	Samodzielny pakiet Python + DuckDB

Wymagania wstępne

• Obszar roboczy PlaidCloud (rozpocznij bezpłatny okres próbny, jeśli go nie masz).
• Dla ścieżki A: istniejący projekt widoczny na karcie Projekty — Twój własny, współdzielony przykład lub dowolny, do którego dostęp dał Ci współpracownik.
• Dla ścieżki B: plik .zip w formacie przenośnym wyeksportowany przez kogoś albo własny projekt do wyeksportowania.

Nie wiesz, czym jest projekt? Projekt to jednostka pracy w PlaidCloud — posiada własne dane, przepływy pracy, wymiary i historię i nie dzieli stanu z żadnym innym projektem. Jeśli to dla Ciebie nowość, przeczytaj najpierw Projekty.

Ścieżka A: skopiuj istniejący projekt

Kopiowanie tworzy pełny, edytowalny duplikat — w całości lub tylko wybranych części — w zupełnie nowym projekcie, który jest w całości Twój.

1. Otwórz Analizuj i wybierz kartę Projekty.
2. Wybierz projekt, od którego chcesz zacząć.
3. Kliknij przycisk Akcje i wybierz Kopiuj projekt.
4. Jako cel wybierz nowy projekt. Nadaj mu nazwę i ID.
5. Pozostaw drzewo wyboru w pełni zaznaczone, aby przenieść cały projekt, a następnie kliknij Kopiuj projekt.

ID jest stałe. ID nadane nowemu projektowi staje się nazwą jego schematu i nie można go później zmienić. Wybierz coś, z czym chcesz żyć — nazwę można zmienić w dowolnym momencie, ID nie.

Kopiowanie odbywa się w tle; dostaniesz powiadomienie po zakończeniu. Pełny opis okna dialogowego znajdziesz w Kopiowanie projektu.

Przenieś tylko te części, które chcesz

Nie musisz kopiować wszystkiego. Drzewo wyboru wyświetla zawartość projektu według typu — przepływy pracy, kroki, tabele, wymiary, edytory danych, funkcje zdefiniowane przez użytkownika — i możesz zaznaczyć tylko te części, które chcesz. Wszystko, co zaznaczysz, automatycznie zabiera ze sobą swoje zależności: tabele, które krok odczytuje i zapisuje, wymiary, względem których ładuje, funkcje, które wywołuje, oraz każdy podprzepływ pracy, który uruchamia. Nigdy nie musisz sam ustalać tych zależności.

Niech odwołania wskazują na Twoją kopię. Pozostaw włączone Aktualizuj odwołania (ustawienie domyślne). Przepisuje ono skopiowane kroki tak, aby wskazywały tabele i obiekty w Twoim nowym projekcie, a nie z powrotem na oryginał — prawie zawsze tego właśnie chcesz. Wyłącz je tylko wtedy, gdy celowo chcesz, aby kopia nadal odczytywała obiekty projektu źródłowego.

Ścieżka B: zacznij od przenośnego pakietu

Przenośny pakiet to projekt spakowany jako samodzielny program w Pythonie, który działa na DuckDB bez połączenia z PlaidCloud. To sposób na start od działającego projektu, gdy chcesz, aby działał poza platformą — na laptopie, w zadaniu CI lub w rękach kogoś, kto nie ma loginu do PlaidCloud.

Jeśli współpracownik dał Ci już pakiet, przejdź do Uruchom go. Aby stworzyć go samodzielnie:

1. Otwórz Analizuj i wybierz kartę Projekty.
2. Wybierz pojedynczy projekt.
3. Otwórz menu Akcje i wybierz Eksportuj do formatu przenośnego.
4. Ustaw Konto dokumentów i Ścieżka folderu, do których zapisywany jest pakiet, pozostaw zaznaczone Include data, aby działał bez żadnego zewnętrznego źródła, i kliknij Eksportuj.

Wynikiem jest plik .zip zawierający jeden skrypt Pythona na przepływ pracy, migawki danych w formacie Parquet, plik requirements.txt z listą pakietów Pythona potrzebnych skryptom oraz pliki README.md, COVERAGE.md i RUN_ORDER.md. Co zawiera każdy plik, opisano w Eksport do formatu przenośnego.

Przenośny pakiet to jednokierunkowa migawka, a nie ponowny import. Działa poza PlaidCloud i nie synchronizuje się z powrotem — zmiany wprowadzone w pakiecie nie wracają do projektu, a ponowny eksport po edycjach tworzy świeży pakiet. Aby dalej pracować w PlaidCloud, użyj zamiast tego ścieżki A. Aby dalej rozwijać projekt w PlaidCloud i rozdać uruchamialną kopię, zrób oba.

Wierność jest dokładana w miarę możliwości. Kroki transformacji SQL są odtwarzane dokładnie. Kroki zastrzeżone i powodujące skutki uboczne — alokacje, ładowanie wymiarów, powiadomienia, kroki dokumentów i raportów, skrypty — są eksportowane jako zaślepki, które nie uruchamiają się ponownie; zamiast tego dołączana jest jako migawka ich ostatnio zmaterializowana wartość wyjściowa. Wierność każdego kroku jest zapisana w COVERAGE.md. Aby uzyskać w pełni przeliczone wyniki, uruchom projekt w PlaidCloud.

Uruchom go

Rozpakuj pakiet, utwórz środowisko Pythona i uruchom skrypt każdego przepływu pracy w kolejności podanej w RUN_ORDER.md:

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python pipeline_<workflow>.py

Każdy skrypt buduje swoje tabele w lokalnej bazie danych DuckDB. Kroki SQL przeliczają się na żywo; kroki zastąpione zaślepkami pozostawiają na miejscu swoje dane wyjściowe z migawki.

Uczyń go swoim

Niezależnie od tego, jak zacząłeś, kopia jest teraz Twoja do zmiany — tu zwraca się sukces pierwszego dnia. Kilka pierwszych ruchów:

Zrób to	Gdzie
Skieruj importy na swoje dane zamiast na dane z przykładu	Kroki importu w każdym przepływie pracy — zobacz Ładowanie, przekształcanie i publikowanie danych
Zmień nazwę projektu lub dostosuj, kto może go otworzyć	Zarządzanie projektami → Kontrola dostępu
Ustaw zmienne projektu dla wartości powtarzających się w przepływach pracy	Zarządzanie zmiennymi projektu
Potwierdź, że całość nadal działa od początku do końca	Kliknij Uruchom na każdym przepływie pracy i obserwuj dziennik

Ponieważ każda zmiana jest śledzona, możesz swobodnie eksperymentować — automatyczne śledzenie zmian pozwala odzyskać dowolny wcześniejszy stan z punktu w czasie, jeśli edycja pójdzie źle.

Dokąd dalej

• Projekty — jak projekty organizują dane, przepływy pracy i historię
• Zarządzanie projektami — kopiowanie, konfiguracja i kontrola dostępu
• Eksport do formatu przenośnego — spakuj projekt jako samodzielny program działający poza platformą
• Wyświetlanie projektów — znajdź i otwórz widoczne dla Ciebie projekty
• Twoje pierwsze 15 minut — wycieczka z przewodnikiem, jeśli wolisz zacząć od czystego konta
• Ładowanie, przekształcanie i publikowanie danych — zbuduj przepływ pracy krok po kroku, gdy projekt będzie już Twój