Aracılığıyla paylaş

psql ile bağlanma

Önemli

Lakebase Otomatik Ölçeklendirme, otomatik ölçeklendirme işlemi, sıfıra ölçeklendirme, dallanma ve anında geri yükleme ile Lakebase'in en son sürümüdür. Desteklenen bölgeler için bkz . Bölge kullanılabilirliği. Lakebase Tedarik Edilmiş bir kullanıcıysanız, bkz. Lakebase Tedarik Edilmiş.

psql PostgreSQL için yerel komut satırı istemcisidir. Postgres'e komut göndermek ve geçici sorgular çalıştırmak için etkileşimli bir oturum sağlar. hakkında psqldaha fazla bilgi için PostgreSQL belgelerindeki psql başvurusuna bakın.

Önkoşullar

  • psql sisteminizde yüklü sürüm 14 veya üzeri
  • Postgres rolü yapılandırılmış bir Lakebase projesi

Uyarı

ile bağlanırken psql kullanmanızı öneririz. Yerel Postgres parolalarının süresi OAuth belirteçleri gibi saatlik olarak dolmaz ve bu da kimlik bilgilerini sık sık yenileyemeyen uygulamalar için daha uygun hale getirir. Kimlik doğrulama yöntemleri hakkındaki ayrıntılar için bkz. Kimlik doğrulamasına genel bakış .

İstemci tarafı güvenlik duvarı kullanırken ağ yapılandırması ve IP adreslerinin izin listesine alınması için bkz: Bağlantı dizeleri.

psql yükleme

psql Yüklemediyseniz şu adımları izleyin:

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 işletim sistemi

sudo apt update
sudo apt install postgresql-client

Windows

postgreSQL'i postgresql.org/download/windows indirip yükleyin. Kurulumda psql öğesinin dahil olduğundan emin olun.

Veritabanınıza bağlanma

kullanarak psql bağlanmanın en kolay yolu bir bağlantı dizesi kullanmaktır.

  1. Lakebase Uygulamasına gidin ve projenizi seçin
  2. Veritabanı bağlantı penceresini açmak için Bağlan'a tıklayın
  3. Bağlanmak istediğiniz dalı, işlem ve veritabanını seçin
  4. Açılan listeden bir Postgres rolü seçin (parola kimlik doğrulaması ile yerel bir Postgres rolü kullanmanızı öneririz)
  5. Bağlantı dizesini kopyalayın

Postgres rol bağlantısı iletişim kutusu

İstemciyi psql bağlantı dizesiyle çalıştırın:

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

Örnek değerleri gerçek bağlantı ayrıntılarınızla değiştirin.

Uyarı

Lakebase, tüm bağlantıların SSL/TLS şifrelemesi kullanmasını gerektirir. sslmode=require parametresi varsayılan olarak tüm bağlantı dizelerine eklenir.

Sorgu çalıştırma

Bağlantı kurduktan sonra SQL sorgularını doğrudan çalıştırabilirsiniz:

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

Meta komutlar

psql veritabanınızla etkileşime yönelik kısayollar sağlayan meta komutları destekler. Bu komutlar ters eğik çizgiyle (\) başlar ve tam SQL sorguları yazmaya gerek kalmadan veritabanı şemalarına ve diğer kritik bilgilere hızlı erişim sağlayarak iş akışınızı önemli ölçüde hızlandırabilir.

Meta komutların avantajları

Meta komutlar iş akışınızı şu şekilde önemli ölçüde hızlandırabilir:

  • Veritabanı şemalarına ve yapısına hızlı erişim sağlama
  • Tam SQL sorguları yazmadan veritabanı nesnelerini görüntüleme
  • Veritabanı bağlantılarını ve oturumlarını yönetme
  • SQL komutları hakkında yardım alma

Yaygın meta komutlar

Sık kullanılan bazı meta komutlar şunlardır:

  • \l — Tüm veritabanlarını listeleme
  • \c DATABASE_NAME — Farklı bir veritabanına bağlanma
  • \dt — Geçerli veritabanındaki tüm tabloları listeleme
  • \d TABLE_NAME — Tablonun yapısını açıklama
  • \di — Dizinleri listeleme
  • \dv — Liste görünümleri
  • \du — Rol listesi
  • \dn — Şemaları listeleme
  • \df — Liste işlevleri
  • \? — Kullanılabilir meta komutların bir bilgi sayfasını göster
  • \h [NAME] — Herhangi bir Postgres komutu için yardım alın (örn. \h SELECT)
  • \q — Psql'den çıkın

Bilgilendirme meta komutları

Veritabanı nesneleri hakkında ayrıntılı bilgi için (seçenekler: S = sistem nesnelerini göster, + = ek ayrıntı):

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

Değiştirici + ek ayrıntılar ekler ve S değiştirici sistem nesnelerini içerir.

Meta komutların tam listesi için psql'de komutunu çalıştırın \? veya PostgreSQL belgelerindeki psql Meta Komutları'na bakın.

Bağlantı seçenekleri

Ayrıca tek tek parametreleri kullanarak bağlantı ayrıntılarını belirtebilirsiniz:

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

Veya ortam değişkenlerini ayarlayın:

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

psql

Bağlantı dizeleri ve kimlik doğrulama seçenekleri hakkında daha fazla bilgi için bkz. Projenize bağlanma.

  • Last updated on