Przejdź do dokumentacji

TWORZENIE TABEL W SPOSÓB WIZUALNY

Diagram DB — poradnik

Projektuj tabele wizualnie, definiuj klucze i indeksy, łącz klucze obce oraz zapisuj lub eksportuj diagram relacyjnej bazy danych.

Tabele i kolumny → ERD i SQLOtwórz diagram bazy danych

Projektuj tabele bezpośrednio na obszarze roboczym bazy danych

Diagram DB tworzy schemat relacyjny z tabel, kolumn, kluczy oraz relacji opartych na kluczach obcych. Dodawaj i edytuj model wizualnie; SQL jest eksportem projektu, a nie źródłem, które musisz utrzymywać.

Jest to niezależne od narzędzia SQL do ERD, które zaczyna się od źródła SQL, oraz od Kreatora ERD, który modeluje koncepcyjne diagramy Chena i EER. Plik Diagramu DB nie nadpisuje obszaru roboczego SQL ani modelu Chena.

Zbuduj swój pierwszy diagram relacyjny

  1. Otwórz Diagram DB i wybierz Pusta baza danych lub szablon Baza zamówień. Wybierz SQLite, PostgreSQL, MySQL lub SQL Server w kontrolce bazy danych przed wybraniem typów i wartości domyślnych.
  2. Wybierz Dodaj tabelę. Otworzy się jej lewy edytor z kolumną klucza głównego id. Zmień nazwę tabeli, dodaj kolumny i wprowadź nazwę oraz typ każdej kolumny. Użyj kontrolek N i Key, aby określić możliwość przyjmowania wartości NULL oraz przynależność do klucza głównego.
  3. Dodaj drugą tabelę z pasującym typem klucza obcego. W akcjach tej kolumny wybierz Połącz z kluczem. Wybierz kolumnę potomną w sekcji Z tabeli i Kolumna klucza obcego, a następnie wybierz referenced key (klucz powiązany) rodzica.
  4. Rozmieść tabele i wybierz Przejrzyj, aby uzyskać opcjonalne sugerowane projekty. Wyeksportuj SQL, aby sprawdzić wygenerowane definicje, lub otwórz je w osobnym obszarze roboczym SQL.
  5. Nazwij projekt i wybierz Zapisz, aby zachować plik w chmurze, logując się w razie potrzeby. Użyj opcji Plik → Pobierz JSON, aby uzyskać edytowalną kopię zapasową. Zapisz ponownie po wprowadzeniu późniejszych zmian.

Tabele, kolumny i ograniczenia

Użyj opcji Dodaj tabelę, aby utworzyć tabelę relacyjną. Nazwy tabel muszą być unikalne w projekcie; nazwy kolumn muszą być unikalne w ramach swojej tabeli. Nazwy są ujmowane w cudzysłów w wyniku SQL, dzięki czemu spacje i słowa zastrzeżone są zachowywane.

Lewy panel to edytor tabel. Każda tabela ma swój kolor w obszarze roboczym oraz podsumowanie kolumn, kolumn klucza głównego i relacji. Więcej akcji pozostaje widocznych; najechanie myszką lub fokus klawiatury ujawnia Zmień nazwę i Znajdź, a ekrany dotykowe utrzymują je widocznymi. Otwórz tabelę za pomocą jej nazwy lub strzałki, aby edytować nazwy i typy kolumn w wierszu. Wejście lub opuszczenie pola zatwierdza poprawną wartość; Klawisz Escape przywraca poprzednią wartość. Niekompletna lub niepoprawna edycja pozostaje widoczna wraz z wyjaśnieniem.

Kontrolka N pozwala na NULL, gdy jest aktywna; jej wyłączenie wymaga podania wartości. Kontrolka klucza ustawia przynależność do klucza głównego. Kolumny klucza głównego nie mogą zezwalać na NULL. Otwórz akcje kolumny, a następnie Opcje kolumny, aby ustawić opcję Unikalne, Autoinkrementacja lub Wartość domyślna (wyrażenie SQL). Odznaki w wierszu podsumowują wartości domyślne, unikalność, wartości wygenerowane automatycznie oraz klucze powiązane.

Wybór lub edycja tabeli w lewym panelu podświetla jej kartę na kanwie bez zmiany powiększenia czy przesuwania. Użyj opcji Zlokalizuj, aby celowo ją wyśrodkować. Wybór lub przeciągnięcie tabeli na kanwie podświetla ją bez rozwijania lewego edytora lub przełączania paneli telefonu. Użyj jej ikony ołówka, aby otworzyć edytor, lub kliknij dwukrotnie kolumnę na kanwie, aby przejść do tego wiersza. Wybór innej tabeli na kanwie utrzymuje obecny edytor otwartym, dopóki celowo nie otworzysz innego lub go nie zwiniesz.

Przeciągnij uchwyt kolumny, aby zmienić kolejność wierszy wewnątrz jej tabeli, lub wybierz Przenieś kolumnę w górę / Przenieś kolumnę w dół z jej akcji. Zmiana kolejności zmienia kolejność definicji, zachowując powiązane relacje. Menu otwierają się obok wybranego elementu i zamykają po kliknięciu na zewnątrz.

Akcje tabeli obejmują duplikowanie, usuwanie, komentarze i indeksy. Duplikowanie tworzy osobno edytowalną tabelę z nowymi identyfikatorami i nieużywaną nazwą, zachowując definicje kolumn, indeksy, komentarz, kolor, względny układ oraz relacje samoodwołujące się. Nie klonuje relacji do innych tabel.

Zduplikowana kolumna pojawia się w akcjach kolumny. Umieszcza kopię bezpośrednio za oryginałem i ustawia fokus na jej nową, nieużywaną nazwę. Typ, domyślna wartość SQL, dopuszczalność wartości NULL i unikalność są zachowane; flagi klucza głównego i autoinkrementacji, relacje oraz przynależność do nazwanego indeksu pozostają przy oryginale. Typy i wartości domyślne zachowują swoje natywne zachowanie, więc PostgreSQL SERIAL nadal generuje wartości.

Kliknij odznakę klucza odwoływanego, aby przejść do jego dokładnej tabeli i kolumny bez zmiany powiększenia lub przesuwania diagramu. Wyszukiwanie, które ukrywało cel, zostaje wyczyszczone. Możesz śledzić odwołania również w udostępnionych projektach tylko do odczytu.

Klucz główny identyfikuje wiersz. Klucze obce używają stabilnych tożsamości tabeli i kolumny, więc zmiana nazwy punktu końcowego utrzymuje powiązanie. Usunięcie tabeli lub kolumny usuwa powiązane z nią relacje; przejrzyj operację przed jej potwierdzeniem.

Wybierz typy odpowiednie dla wybranego dialektu. Diagram wyraża zamierzony projekt; przeanalizuj wyeksportowany SQL i zweryfikuj go z własną bazą danych przed wdrożeniem.

Wybierz typy i domyślne wyrażenia

Otwórz listę rozwijaną Typ, aby wyszukać sugestie dla wybranej bazy danych, lub wpisz typ niestandardowy. Opcje kolumn dodają komentarze i reguły walidacji: zakres numeryczny, długość tekstu lub dozwolone wartości tekstowe. Granice są domknięte; wartość NULL jest kontrolowana osobno. Reguły i komentarze są zapisywane i eksportowane wraz z kolumną.

Wprowadź tylko typ danych w polu Typ, taki jak INTEGER, VARCHAR(120) lub DECIMAL(10,2). Sugestie są punktem wyjścia; można wpisać inne nazwy typów. Zachowaj PRIMARY KEY, NOT NULL, UNIQUE i DEFAULT w oddzielnych kontrolkach zamiast dopisywać je do typu.

Wartość domyślna akceptuje wyrażenie SQL. Użyj 0 dla liczby, CURRENT_TIMESTAMP dla znacznika czasu lub pojedynczych cudzysłowów wokół tekstu, takiego jak 'pending'. Pozostaw pole puste, aby nie było wartości domyślnej. Wartość domyślna dostarcza wartość, gdy instrukcja INSERT pomija kolumnę; nie ogranicza ona wartości, które mogą być przechowywane.

Auto increment wymaga pojedynczego integer (całkowitego) klucza głównego i nie może jednocześnie używać wyrażenia domyślnego. SQLite wymaga typu INTEGER dla tej opcji. Typy całkowite w MySQL mogą być UNSIGNED; typy powiązane i powiązujące nadal muszą być ze sobą zgodne. PostgreSQL SERIAL oraz inne natywne typy lub wyrażenia domyślne zachowują własne zachowanie bazy danych, nawet gdy osobna flaga Auto increment jest wyłączona.

Zmiana bazy danych weryfikuje bieżący model pod kątem tego dialektu. Istniejące typy i wyrażenia domyślne są zachowywane, a nie przepisywane automatycznie. Jeśli klucz, nazwa lub akcja relacji nie są obsługiwane, bieżący projekt pozostaje nienaruszony, a komunikat wyjaśnia, co należy dostosować.

Formularz kolumny na obszarze roboczym zachowuje dokładne wyrażenia domyślne, w tym ujęte w cudzysłów nazwy funkcji lub schematów. Jeśli klauzula kolumny nie może zostać zachowana przez ten model wizualny, na przykład niestandardowy początek sekwencji tożsamości (seed) lub zachowanie ON CONFLICT, wyjaśnia ona ograniczenie zamiast usuwać tę regułę. Zachowaj te definicje w obszarze roboczym SQL, gdy ich potrzebujesz.

Przejrzyj opcjonalne sugestie dotyczące projektu

Wybierz Przeglądaj nad listą tabel, aby sprawdzić sugestie dotyczące pustych tabel, brakujących kluczy głównych, nieindeksowanych kolumn klucza obcego oraz dokładnie zduplikowanych definicji indeksów. Wybierz sugestię, aby wyświetlić jej tabelę, kolumnę lub indeks w lewym panelu bez przesuwania kamery obszaru roboczego.

Te sugestie są opcjonalne. Tabele bez kluczy głównych mogą być celowe, a wybór indeksów zależy od obciążenia pracą. Przegląd nie modyfikuje modelu ani nie dodaje dodatkowych ograniczeń dotyczących zapisywania lub eksportowania. Brak sugestii oznacza jedynie, że te konkretne sprawdzenia niczego nie znalazły do przeglądu.

W przypadku wyszukiwań po kluczu obcym, klucz główny, unikalna kolumna lub nazwany indeks obejmują swoją wiodącą kolumnę. Późniejsza kolumna w kluczu złożonym lub sam indeks nie zapewniają tego prefiksu. MySQL automatycznie tworzy wspierające indeksy dla kluczy obcych, więc ten przegląd pomija tę sugestię w tym systemie.

Otwórz sugestię indeksu, aby przejść do pasującego wiersza indeksu, a następnie wybierz, czy chcesz go edytować, czy usunąć za pomocą istniejących kontrolek. Zmiany obsługują Cofnij, a recenzja aktualizuje się w miarę pracy.

Opisz tabelę i zdefiniuj prawdziwe indeksy

Użyj pola Komentarz tabeli, aby opisać jej przeznaczenie. Komentarz jest zapisywany wraz z edytowalnym modelem i uwzględniany w eksporcie SQL przy użyciu natywnej składni komentarzy wybranego dialektu.

Dodaj indeks z poziomu rozszerzonego edytora tabeli. Nazwij go, wybierz kolejno jedną lub więcej kolumn i zdecyduj, czy ma być unikalny. Są to zapisane obiekty schematu, które w eksporcie SQL stają się instrukcjami CREATE INDEX lub CREATE UNIQUE INDEX; etykieta indeksu nie zastępuje faktycznej definicji indeksu.

Zwykły indeks może pomóc zapytaniom w znajdowaniu danych. Indeks unikalny dodatkowo ogranicza indeksowane wartości. Dopasuj kolejność kolumn do wymagań zapytania i sprawdź zachowanie docelowej bazy danych dla wartości NULL oraz limitów typów. Indeksy oparte na wyrażeniach i predykaty indeksów częściowych nie są tutaj modelowane.

Tabela obsługuje do 50 indeksów; projekt obsługuje do 1000 indeksów. Komentarze tabeli obsługują do 2000 znaków. Usunięcie indeksowanej kolumny usuwa ją z każdego dotkniętego indeksu oraz usuwa indeks, jeśli nie pozostały w nim żadne kolumny.

Unikalny indeks jednokolumnowy może kwalifikować swoją kolumnę jako klucz referencyjny. Wielokolumnowy indeks unikalny nie sprawia, że każda kolumna jest indywidualnie unikalna. Usunięcie jedynego kwalifikującego się unikalnego klucza używanego przez klucz obcy jest odrzucane; najpierw celowo zmień lub usuń zależną relację.

Połącz klucze obce w odpowiednim kierunku

Kolumna odwołująca się należy do tabeli podrzędnej. Powiązany klucz główny lub unikalny należy do tabeli nadrzędnej. Na przykład orders.customer_id odwołuje się do customers.id.

Wybierz Relację nad obszarem roboczym, dodaj relację w rozwijanej tabeli, połącz się z kluczem w akcjach kolumny lub przeciągnij między krawędziami kolumn w obszarze roboczym. Formularz oferuje zgodne istniejące klucze. Kolumny odwołujące się i odwoływane muszą mieć pasujące typy, w tym odpowiednią szerokość, skalę i modyfikators; rozpoznawane aliasy, takie jak INT i INTEGER, są traktowane spójnie.

Relacja może łączyć jedną kolumnę lub kilka par kolumn. Wybierz pełny wskazywany klucz główny lub unikatowy, a następnie sprawdź sugerowane dopasowania. Klucz złożony tworzy jedną relację, a nie oddzielne klucze jednokolumnowe.

Użyj opcji Edytuj relację w sekcji Relacje tabeli, aby zmienić wszystkie pary razem. Usunięcie dowolnej uczestniczącej kolumny lub łącznika usuwa całą relację; Cofnij ją przywraca.

Klucz obcy sam w sobie nie sprawia, że wartość potomna jest wymagana lub unikalna. Wyłącz opcję NULL, aby wymagać rodzica dla każdego potomka; dodaj Unikalność tylko wtedy, gdy ten sam klucz rodzica nie może wystąpić w więcej niż jednym wierszu potomnym. Żadne z tych ustawień nie wymaga, aby każdy rodzic miał potomka.

Otwórz Relacje w rozwiniętej tabeli i rozwiń połączenie, aby wybrać On delete lub On update. Wartością domyślną jest NO ACTION. CASCADE, RESTRICT, SET NULL i SET DEFAULT są dostępne w zależności od wybranego dialektu i modelu: SQL Server używa NO ACTION zamiast RESTRICT; MySQL nie obsługuje SET DEFAULT; SET NULL wymaga kolumny podrzędnej typu nullable; SET DEFAULT wymaga wyrażenia domyślnego. Wartości domyślne i ścieżki kaskadowe nadal wymagają sprawdzenia w docelowej bazie danych.

Zmiana nazwy dowolnego punktu końcowego zachowuje jego połączenie. Usunięcie relacji usuwa połączenie, zachowując obie kolumny; usunięcie tabeli lub kolumny usuwa również połączenia, które z niej korzystają.

SQLite SQL / Tabele referencjonujące i referencjonowane
CREATE TABLE customers (
  id INTEGER PRIMARY KEY,
  name TEXT NOT NULL
);

CREATE TABLE orders (
  id INTEGER PRIMARY KEY,
  customer_id INTEGER,
  FOREIGN KEY (customer_id) REFERENCES customers(id)
);
Podczas testowania kluczy obcych w SQLite lub jego podglądzie danych, uruchom PRAGMA foreign_keys = ON poza transakcją dla tego połączenia. Zdefiniowanie klucza obcego i włączenie jego egzekwowania to osobne kroki.

Rozmieszczaj i nawiguj bez zmieniania schematu

Przeciągnij nagłówki tabel, aby je przenieść. Użyj powiększenia i opcji Dopasuj do ekranu, aby odnaleźć swoje miejsce. Pozycje na obszarze roboczym, kolory i elementy sterujące widokiem wpływają na prezentację, a nie na relacyjne znaczenie modelu.

Kolory tabel używają tego samego algorytmu uwzględniającego schemat co SQL do ERD. Brakujące kolory są przypisywane automatycznie; istniejące kolory ręczne i gradienty są zachowywane. Użyj Kolorów tabel dla opcji Jasne, Zrównoważone, Głębokie lub Wyraziste albo wybierz własny kolor tabeli. Wskaźniki na pasku bocznym pokazują te same kolory co obszar roboczy, w tym podglądy gradientów. Zmiany motywu zachowują zapisane wybory.

Na komputerze przeciągnij separator między tabelami a kanwą, aby zmienić ich rozmiar. Skup się na separatorze i użyj strzałek w lewo/w prawo, klawisza Shift dla większych kroków lub Home/End dla jego granic. Dwukrotne kliknięcie przywraca domyślną szerokość; Escape anuluje przeciąganie. Kliknij wyśrodkowaną strzałkę, aby ukryć panel tabel i otworzyć go ponownie na jego poprzedniej szerokości, zachowując edytor i wyszukiwanie. Ołówek na kanwie lub edycja kolumny otwiera go ponownie; zwykłe zaznaczenie nie. Rozmiar i widoczność panelu pozostają lokalne dla tego obszaru roboczego. W telefonach przełączaj się między Diagramem a Tabelami i szczegółami.

Utwórz nazwaną, kolorową grupę z sekcji Grupy na pasku bocznym, a następnie wybierz jej tabele. Tabela należy do jednej grupy naraz; wybranie tabel z innej grupy przenosi je do edytowanej grupy. Przeciągnij nagłówek ramki grupy, aby przenieść jej członków razem, lub naciśnij Escape, aby anulować. Zmiany grupy i przenoszenia obsługują Cofnij/Ponów. Rozgrupowanie zachowuje każdą tabelę, kolumnę i relację; grupy to zapisane metadane prezentacji, które nigdy nie zmieniają wyeksportowanego SQL.

Użyj funkcji Cofnij i Ponów, aby przeglądać zmiany w projekcie, w tym edycje, duplikację, komentarze i indeksy. Menu akcji tabeli i kolumny są zakotwiczone obok ich wyzwalacza, a nie na dole panelu. Wybierz element przed jego edycją lub usunięciem i sprawdź powiązane relacje podczas usuwania tabeli lub kolumny.

Zapisz swój projekt i przejrzyj jego wynik

Nowe projekty pozostają w pamięci, dopóki nie wybierzesz opcji Zapisz lub Plik → Pobierz JSON; nie ma automatycznego szkicu lokalnego. Zapisz loguje w razie potrzeby i tworzy niezależny plik w chmurze Diagramu DB. Pierwszy udany zapis nadaje projektowi jego własny adres URL. Zapisz ponownie po edycji; przycisk pokazuje Zapisywanie… podczas wykonywania żądania, a powiadomienie o sukcesie potwierdza zakończenie.

Plik → Otwórz diagramy otwiera listę plików Diagramu DB. Właściciele mogą edytować i zapisywać swoje pliki. Aby udostępnić, zapisz ostatnie zmiany, a następnie wybierz Plik → Udostępnij diagram i włącz dostęp publiczny. Publiczny przeglądający widzi zapisaną wersję w trybie tylko do odczytu i może ją wyeksportować; link nie nadaje uprawnień do edycji.

Pobierz plik JSON, aby zachować edytowalny model, lub zaimportuj plik JSON wyeksportowany przez to narzędzie. Przenośne importy obsługują do 128 MB i nadal egzekwują limity modelu. Dowolny kod SQL, plik JSON innej aplikacji oraz plik Chen Builder nie są importami do DB Diagram. Import weryfikuje cały plik przed zastąpieniem; gdy bieżący projekt zawiera tabele, prosi o potwierdzenie. Cofnięcie przywraca poprzedni projekt.

Wyeksportuj SQL, aby skopiować lub pobrać skrypt dla wybranego dialektu. Otwórz wygenerowany SQL w obszarze roboczym SQL, aby przejrzeć go obok widoków ERD, Danych i Zapytań. To przekazanie tworzy osobny dokument SQL.

Użyj eksportu obrazu, aby przechwycić diagram jako PNG, SVG lub PDF. SVG zawiera osadzony PNG zamiast edytowalnych kształtów wektorowych; PDF to pojedyncza strona z osadzonym obrazem i tekst bez możliwości zaznaczania. JSON zachowuje edytowalny model Diagramu DB oraz jego wygląd i układ na kanvie.

Jeśli zapisywanie się nie powiódłoby, pozostaw obszar roboczy otwarty, pobierz plik JSON i ponów próbę zapisu, gdy będzie gotowy. Opcja Plik → Nowy diagram otwiera nowy wybór pustego pliku/szablonu. Niezapisane zmiany wyświetlają ostrzeżenie przed opuszczeniem strony, ale ostrzeżenie nie jest kopią zapasową; pobierz lub zapisz model przed zamknięciem strony.

To narzędzie nie łączy się z żywą bazą danych, nie stosuje migracji ani nie wykonuje SQL na danych produkcyjnych.

Skróty klawiaturowe i limity modelu

Skróty klawiaturowe i limity modelu
Akcja lub limitZachowanie
Ctrl/Cmd+SZapisz w chmurze, w tym prawidłowe oczekiwacje edycje pól; zaloguj się po wyświetleniu monitu. Zapisywanie nie jest wywoływane z otwartego okna dialogowego.
Ctrl/Cmd+Z / Ctrl/Cmd+Shift+Z / Ctrl+YCofnij / Ponów poza polami tekstowymi i oknami dialogowymi. Pola tekstowe zachowują swoje natywne skróty edycyjne.
Usuń / BackspaceŻądaj usunięcia wybranej tabeli, kolumny lub indeksu poza polami tekstowymi i oknami dialogowymi; potwierdź usunięcie przed jego zastosowaniem.
Enter / Escape w poluZatwierdź poprawną edycję jednowierszową / anuluj wersję roboczą pola i przywróć poprzednią wartość.
Escape poza polami i oknami dialogowymiWyczyść zaznaczenie i zamknij edytor rozwiniętej tabeli. Podczas przeciągania separatora lub grupy anuluj to podgląd.
Tabele i kolumny200 tabel, 200 kolumn na tabelę i 5000 kolumn ogółem.
Relacje i indeksy1000 relacji i 5000 par kolumn; 50 nazwanych indeksów na tabelę i 1000 na projekt.
Komentarze i nazwa pliku w chmurze2000 znaków na komentarz tabeli lub kolumny (1024 dla komentarzy kolumn MySQL); 3–259 znaków dla nazwy pliku w chmurze. Identyfikatory bazy danych mają limity specyficzne dla dialektu.
HistoriaDo 80 stanów cofnięcia w bieżącym obszarze roboczym. Historia cofania nie jest częścią zapisanego pliku.

Zrozumienie ostrzeżenia projektu

Zrozumienie ostrzeżenia projektu
Co widziszCo sprawdzić
Nazwa tabeli lub kolumny jest już używanaWybierz inną nazwę w tej tabeli lub projekcie. Zasady dotyczące wielkości liter i cudzysłowów różnią się między bazami danych; sprawdź wyeksportowane identyfikatory.
Nie można dodać relacjiWybierz pełny wskazywany klucz główny lub unikatowy i zgodne typy dla każdej pary kolumn. Sprawdź długość, skalę, typy bez znaku i modyfikatory tablic.
Modyfikacja pozostaje widoczna wraz z błędemPrzeczytaj komunikat pod polem, popraw wartość i zatwierdź ponownie lub naciśnij Escape, aby przywrócić poprzednią wartość. Odrzucona edycja nie zmieniła modelu.
Połączenie zniknęło po usunięciuUsunięcie tabeli lub kolumny powoduje usunięcie powiązanych z nią relacji. Użyj opcji Cofnij, jeśli usunięcie było niezamierzone.
Udostępnionego projektu nie można edytowaćPliki publiczne są tylko do odczytu. Właściciel edytuje i zapisuje oryginał.
Wyeksportowany SQL wymaga dostosowaniaPrzed uruchomieniem skryptu sprawdź wybrany dialekt, typy, wartości domyślne, reguły kluczy oraz docelową wersję bazy danych.

Poproś asystenta o przegląd modelu

Skopiuj ten przewodnik jako monit AI i opisz swoje tabele, kolumny, klucze, kierunek relacji oraz docelowy dialekt. Poproś asystenta o wyjaśnienie niejednoznacznych reguł biznesowych przed zaproponowaniem ograniczeń.

Zbuduj zweryfikowany model za pomocą kontrolek wizualnych. Możesz udostępnić wygenerowany SQL asystentowi do przeglądu, ale importowanie dowolnego SQL lub wymyślonego dokumentu JSON Diagramu DB nie jest obsługiwane.

AI request / Prośba o przegląd projektu bazy danych
Review a SQLite database design for customers and orders.
Each order belongs to one existing customer.
Explain the referencing and referenced columns.
Recommend primary keys, nullability, and useful uniqueness rules.
Do not assume that every customer must already have an order.