Udostępnij przez

Nawiązywanie połączenia za pomocą narzędzia psql

Ważne

Skalowanie automatyczne bazy danych Lakebase znajduje się w wersji beta w następujących regionach: eastus2, westeurope, westus.

Autoskalowanie bazy danych Lakebase to najnowsza wersja bazy danych Lakebase z automatycznym skalowaniem obliczeniowym, skalowaniem do zera, rozgałęzianiem i natychmiastowym przywracaniem. Aby zapoznać się z porównaniem funkcji z aprowizowaną usługą Lakebase, zobacz wybieranie między wersjami.

psql to natywny klient wiersza polecenia dla bazy danych PostgreSQL. Zapewnia interakcyjną sesję wysyłania poleceń do bazy danych Postgres i uruchamiania zapytań ad hoc. Aby uzyskać więcej informacji na temat psql, zobacz odnośnik do psql w dokumentacji PostgreSQL.

Wymagania wstępne

  • psql wersja 14 lub nowsza zainstalowana w systemie
  • Projekt usługi Lakebase ze skonfigurowaną rolą Postgres

Uwaga / Notatka

Zalecamy używanie natywnego uwierzytelniania haseł Postgres podczas nawiązywania połączenia z usługą psql. Natywne hasła postgres nie wygasają co godzinę, takich jak tokeny OAuth, dzięki czemu lepiej nadają się do obsługi aplikacji, które nie mogą często odświeżać poświadczeń. Zobacz Omówienie uwierzytelniania , aby uzyskać szczegółowe informacje o metodach uwierzytelniania.

Instalowanie narzędzia psql

Jeśli nie zainstalowano psql programu , wykonaj następujące kroki:

MacOS (Intel)

brew install libpq
echo 'export PATH="/usr/local/opt/libpq/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

MacOS (Apple Silicon)

brew install libpq
echo 'export PATH="/opt/homebrew/opt/libpq/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux

sudo apt update
sudo apt install postgresql-client

Windows

Pobierz i zainstaluj program PostgreSQL z postgresql.org/download/windows. Upewnij się, że psql jest uwzględniona w instalacji.

Nawiązywanie połączenia z bazą danych

Najprostszym sposobem na nawiązanie połączenia z użyciem psql jest skorzystanie z ciągu połączenia.

  1. Przejdź do aplikacji Lakebase i wybierz projekt
  2. Kliknij Połącz, aby otworzyć okno połączenia z bazą danych
  3. Wybierz gałąź, obliczenia i bazę danych, z którą chcesz nawiązać połączenie
  4. Wybierz rolę Postgres z listy rozwijanej (zalecamy użycie natywnej roli Postgres z uwierzytelnianiem haseł)
  5. Kopiowanie parametrów połączenia

Okno dialogowe połączenia roli Postgres

psql Uruchom klienta z parametrami połączenia:

psql 'postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require'

Zastąp przykładowe wartości rzeczywistymi szczegółami połączenia.

Uwaga / Notatka

Usługa Lakebase wymaga, aby wszystkie połączenia używały szyfrowania SSL/TLS. Parametr sslmode=require jest domyślnie uwzględniany we wszystkich parametrach połączenia.

Uruchamianie zapytań

Po nawiązaniu połączenia można uruchamiać zapytania SQL bezpośrednio:

CREATE TABLE my_table AS SELECT now();
SELECT * FROM my_table;

Metaza pomocą poleceń

psql obsługuje meta-polecenia, które udostępniają skróty do interakcji z bazą danych. Te polecenia zaczynają się od ukośnika odwrotnego (\) i mogą znacznie przyspieszyć przepływ pracy, zapewniając szybki dostęp do schematów bazy danych i innych krytycznych informacji bez konieczności pisania pełnych zapytań SQL.

Zalety metapoleceń

Meta-polecenia mogą znacznie przyspieszyć przepływ pracy, wykonując następujące czynności:

  • Zapewnianie szybkiego dostępu do schematów i struktury bazy danych
  • Wyświetlanie obiektów bazy danych bez zapisywania pełnych zapytań SQL
  • Zarządzanie połączeniami i sesjami bazy danych
  • Uzyskiwanie pomocy dotyczącej poleceń SQL

Typowe metapolecenia

Oto niektóre często używane meta-polecenia:

  • \l — Wyświetlanie listy wszystkich baz danych
  • \c DATABASE_NAME — Nawiązywanie połączenia z inną bazą danych
  • \dt — Wyświetlanie listy wszystkich tabel w bieżącej bazie danych
  • \d TABLE_NAME — Opisywanie struktury tabeli
  • \di — Lista indeksów
  • \dv — Wyświetlanie listy widoków
  • \du — Wyświetlanie listy ról
  • \dn — Schematy listy danych
  • \df — Funkcje listy
  • \? — Pokaż listę pomocniczą dostępnych meta-poleceń
  • \h [NAME] — Uzyskaj pomoc dotyczącą dowolnego polecenia Postgres (np. \h SELECT)
  • \q — Zamknij narzędzie psql

Polecenia meta informacyjne

Aby uzyskać szczegółowe informacje o obiektach bazy danych (opcje: S = pokaż obiekty systemowe, + = dodatkowe szczegóły):

Informational
  (options: S = show system objects, + = additional detail)
  \d[S+]                 list tables, views, and sequences
  \d[S+]  NAME           describe table, view, sequence, or index
  \da[S]  [PATTERN]      list aggregates
  \dA[+]  [PATTERN]      list access methods
  \dAc[+] [AMPTRN [TYPEPTRN]]  list operator classes
  \dAf[+] [AMPTRN [TYPEPTRN]]  list operator families
  \dAo[+] [AMPTRN [OPFPTRN]]   list operators of operator families
  \dAp[+] [AMPTRN [OPFPTRN]]   list support functions of operator families
  \db[+]  [PATTERN]      list tablespaces
  \dc[S+] [PATTERN]      list conversions
  \dconfig[+] [PATTERN]  list configuration parameters
  \dC[+]  [PATTERN]      list casts
  \dd[S]  [PATTERN]      show object descriptions not displayed elsewhere
  \dD[S+] [PATTERN]      list domains
  \ddp    [PATTERN]      list default privileges
  \dE[S+] [PATTERN]      list foreign tables
  \des[+] [PATTERN]      list foreign servers
  \det[+] [PATTERN]      list foreign tables
  \deu[+] [PATTERN]      list user mappings
  \dew[+] [PATTERN]      list foreign-data wrappers
  \df[anptw][S+] [FUNCPTRN [TYPEPTRN ...]]
                         list [only agg/normal/procedure/trigger/window] functions
  \dF[+]  [PATTERN]      list text search configurations
  \dFd[+] [PATTERN]      list text search dictionaries
  \dFp[+] [PATTERN]      list text search parsers
  \dFt[+] [PATTERN]      list text search templates
  \dg[S+] [PATTERN]      list roles
  \di[S+] [PATTERN]      list indexes
  \dl[+]                 list large objects, same as \lo_list
  \dL[S+] [PATTERN]      list procedural languages
  \dm[S+] [PATTERN]      list materialized views
  \dn[S+] [PATTERN]      list schemas
  \do[S+] [OPPTRN [TYPEPTRN [TYPEPTRN]]]
                         list operators
  \dO[S+] [PATTERN]      list collations
  \dp[S]  [PATTERN]      list table, view, and sequence access privileges
  \dP[itn+] [PATTERN]    list [only index/table] partitioned relations [n=nested]
  \drds [ROLEPTRN [DBPTRN]] list per-database role settings
  \drg[S] [PATTERN]      list role grants
  \dRp[+] [PATTERN]      list replication publications
  \dRs[+] [PATTERN]      list replication subscriptions
  \ds[S+] [PATTERN]      list sequences
  \dt[S+] [PATTERN]      list tables
  \dT[S+] [PATTERN]      list data types
  \du[S+] [PATTERN]      list roles
  \dv[S+] [PATTERN]      list views
  \dx[+]  [PATTERN]      list extensions
  \dX     [PATTERN]      list extended statistics
  \dy[+]  [PATTERN]      list event triggers
  \l[+]   [PATTERN]      list databases
  \lo_list[+]            list large objects
  \sf[+]  FUNCNAME       show a function's definition
  \sv[+]  VIEWNAME       show a view's definition
  \z[S]   [PATTERN]      same as \dp

Modyfikator + dodaje dodatkowe szczegóły, a S modyfikator zawiera obiekty systemowe.

Aby uzyskać pełną listę meta-poleceń, uruchom \? w psql lub zobacz Polecenia meta dla psql w dokumentacji PostgreSQL.

Opcje połączenia

Szczegóły połączenia można również określić przy użyciu poszczególnych parametrów:

psql -h ep-abc-123.databricks.com -p 5432 -U lakebase -d lakebase

Lub ustaw zmienne środowiskowe:

export PGHOST=ep-abc-123.databricks.com
export PGPORT=5432
export PGDATABASE=lakebase
export PGUSER=lakebase
export PGPASSWORD=your-password

psql

Aby uzyskać więcej informacji na temat parametrów połączenia i opcji uwierzytelniania, zobacz Nawiązywanie połączenia z projektem.

  • Last updated on