PricingLoginStart free
TypeScript Academy · Lekcja

Relacje i złączenia z typami

Modeluj relacje, aby wyniki złączeń miały poprawne typy

Lekcja 4 z 413 kroki

Relacje i złączenia z typami to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Typowane relacje i zagnieżdżone wyniki

Rzeczywiste schematy zawierają relacje: użytkownik ma wiele postów, a post należy do użytkownika. ORM bezpieczny pod względem typów pozwala zadeklarować te relacje, a następnie zwraca poprawnie zagnieżdżone wyniki z pełną informacją o typach z zapytań relacyjnych.

Deklarowanie relacji

Obok tabel definiuje się obiekt relacji opisujący sposób ich połączenia. Te metadane sterują zarówno generowaniem SQL, jak i typem wyniku.

import { relations } from "drizzle-orm";

export const usersRelations = relations(users, ({ many }) => ({
  posts: many(posts),
}));

export const postsRelations = relations(posts, ({ one }) => ({
  author: one(users, {
    fields: [posts.authorId],
    references: [users.id],
  }),
}));

Zapytanie relacyjne

API zapytań umożliwia pobieranie powiązanych wierszy za pomocą with. Wynik zawiera zagnieżdżone powiązane dane pod nazwą relacji.

const result = await db.query.users.findMany({
  with: { posts: true },
});
// result: (User & { posts: Post[] })[]

one a many kształtują typ

Relacja many zwraca tablicę, a relacja one pojedynczy obiekt (lub null). Zagnieżdżony typ odpowiada zadeklarowanej krotności.

const r = await db.query.posts.findMany({
  with: { author: true },
});
// r: (Post & { author: User })[]   // author is a single object

Wybieranie kolumn wewnątrz relacji

Można zawęzić zarówno wiersze nadrzędne, jak i zagnieżdżone. Typ wyniku jest niezależnie zawężany na każdym poziomie.

const r = await db.query.users.findMany({
  columns: { id: true, name: true },
  with: {
    posts: { columns: { title: true } },
  },
});
// r: { id: number; name: string; posts: { title: string }[] }[]

Ręczne złączenia z typowanymi kolumnami

Złączenia niższego poziomu również zachowują kontrolę typów. Predykat złączenia korzysta z typowanych odwołań do kolumn, a select określa płaski kształt wyniku.

const rows = await db
  .select({ author: users.name, title: posts.title })
  .from(posts)
  .innerJoin(users, eq(users.id, posts.authorId));
// rows: { author: string; title: string }[]

left join wprowadza nullowalność

LEFT JOIN może zwrócić brakujący wiersz po prawej stronie, dlatego połączone kolumny stają się nullowalne w typie wyniku. ORM odzwierciedla to automatycznie.

const rows = await db
  .select({ name: users.name, title: posts.title })
  .from(users)
  .leftJoin(posts, eq(posts.authorId, users.id));
// rows: { name: string; title: string | null }[]

Wyniki zagnieżdżone a płaskie

Zapytania relacyjne (findMany + with) zwracają zagnieżdżone obiekty, a ręczne złączenia — płaskie wiersze. Wyniki zagnieżdżone warto wybrać, gdy potrzebny jest graf obiektów, a płaskie, gdy potrzebna jest projekcja tabelaryczna.

Jak typowane jest zagnieżdżanie

Metadane relacji są odczytywane na poziomie typów. Typ zapytania jest przecięciem bazowego wiersza z obiektem, którego kluczami są żądane relacje, a wartościami — typ tablicy lub pojedynczego obiektu, zależnie od zadeklarowanej krotności.

type WithPosts = User & { posts: Post[] };
// "many" -> Post[], "one" -> User (or User | null for optional)

Głęboko zagnieżdżone relacje

Relacje można łączyć. Można zażądać relacji należącej do innej relacji, a typ zostanie zagnieżdżony równie głęboko — wszystko zostanie wywnioskowane automatycznie.

await db.query.users.findMany({
  with: { posts: { with: { comments: true } } },
});
// User & { posts: (Post & { comments: Comment[] })[] }

Dlaczego ma to znaczenie

Ręczne definiowanie typów zagnieżdżonych wyników złączeń jest podatne na błędy i z czasem rozbiega się ze schematem. Wyprowadzanie ich z zadeklarowanych relacji utrzymuje typ grafu obiektów i SQL w ścisłej zgodności, dzięki czemu zmiana nazwy relacji powoduje błąd kompilacji, a nie niespodziankę na produkcji.

Szybkie sprawdzenie

Sprawdź swoją wiedzę na temat typowanych relacji i złączeń.

Odpowiedz w interaktywnej lekcji

Podsumowanie

Zadeklarowałeś relacje, a następnie pozwoliłeś ORM-owi generować zagnieżdżone wyniki z pełną informacją o typach: many zwraca tablice, one pojedyncze obiekty, częściowe wybory zawężają każdy poziom, LEFT JOIN wprowadza nullowalność, a głęboko zagnieżdżone relacje można łączyć. Metadane relacji sterują zarówno SQL, jak i typami wyników, utrzymując je w zgodności.

Bezpłatny start

Ucz się TypeScript dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy
101
Lekcje
352
Zacznij naukę bezpłatnieWyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Relacje i złączenia z typami” jest bezpłatna?

Tak — pełny tekst „Relacje i złączenia z typami” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Relacje i złączenia z typami”?

Modeluj relacje, aby wyniki złączeń miały poprawne typy Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Relacje i złączenia z typami”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Mapowanie schematu na typ
  2. Bezpieczne typowo konstruowanie zapytań
  3. Wnioskowanie kształtów wyników zapytań
  4. Relacje i złączenia z typami
← Powrót do TypeScript Academy