ClickHouse

ClickHouse Cloud, organizasyon ayarlarında oluşturulan bir API anahtarıyla bağlanır. Bir API anahtarı tam olarak tek bir organizasyona aittir, bu yüzden bir anahtar bir organizasyon bağlar ve her organizasyon bir çalışma alanına bir kez bağlanır. Anahtarlar saklanmadan önce şifrelenir ve ajan onları asla görmez.

1. ClickHouse Cloud'u aç, organizasyonunun API Keys'ine git.
2. New API key'e tıkla ve Developer (salt okunur) rolünü seç: Polylane eşitleme sırasında yalnızca okur.
3. Hem anahtar kimliğini hem anahtar gizli anahtarını kopyala; gizli anahtar yalnızca bir kez gösterilir.
4. Her iki değeri Polylane'e yapıştır.
5. Polylane anahtarı doğrular ve eşitlemeye başlar.

Polylane servislerini durum, katman, bölge, bulut sağlayıcısı, ClickHouse sürümü, kopya boyutlandırması ve bağlantı uç noktaları dahil keşfeder. Bağlantı ana bilgisayar adları bulutlar arası bağlama için kullanılır, böylece bir servise ortam değişkeni üzerinden ulaşan uygulamalar haritada ona bağlanır.

İzleme, servisler bozulmuş, başarısız, durmuş veya kısmen çalışır durumdayken bir sorun açar; boşta ve uyanan servisler, boşta ölçeklenen servisler için sıradan yaşam döngüsüdür ve sağlıklı kalır. ClickHouse Cloud denetim düzlemi metrikleri geçmişi olmayan canlı bir anlık görüntü olarak bildirir, bu yüzden ajanlar mevcut değerleri istek üzerine okur ve servisler metrik grafiği taşımaz.

Sorun giderme

"Invalid API key" hatası

• Hem anahtar kimliği hem anahtar gizli anahtarı gereklidir; tek başına biri kimlik doğrulayamaz.
• Anahtarın ClickHouse Cloud'un API anahtarı ayarlarında silinmediğini veya devre dışı bırakılmadığını kontrol et.
• Son kullanma tarihi olan anahtarlar süreleri dolduğunda çalışmayı bırakır; yeni bir anahtar oluştur ve Polylane'de döndür.

Eksik kaynaklar

• ClickHouse Cloud'un her şeyi eşitlemesi birkaç dakika sürebilir.
• Yenilemek için hesap başlığından elle bir Sync tetikle.

Hız sınırları

• ClickHouse Cloud anahtar başına 10 saniyede 10 API isteğine izin verir. Polylane için ayrılmış bir anahtar, bu bütçeyi diğer araçlarla paylaşmaktan kaçınır.

Bağlantıyı kesme

Hesabın Polylane ile bağlantısını kes, sonra API anahtarını ClickHouse Cloud organizasyon ayarlarından sil.

ClickHouse Cloud'u bağlamak tarayıcı gerektirmez: konsolun çağırdığı aynı uç nokta bir CI işine sığar. Kimliği doğrulanmış tek bir POST bağlantıyı oluşturur ve ilk eşitlemeyi başlatır.

Ön koşullar

• cloud_accounts:write ve cloud_accounts:read kapsamlı bir Polylane API anahtarı. Bkz. API anahtarları ve OAuth.
• ws_ ile başlayan çalışma alanı kimliğin. Aynı anahtarla GET /v1/workspaces üzerinden oku.
• Organizasyonunun API Keys'inden, Developer (salt okunur) rolüyle oluşturulmuş bir ClickHouse Cloud API anahtarı kimliği ve gizli anahtarı.

Bağlantıyı oluştur

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "clickhouse",
    "workspaceId": "ws_0abc123",
    "keyId": "<key-id>",
    "keySecret": "<key-secret>"
  }'

Bir API anahtarı tam olarak tek bir organizasyona aittir, bu yüzden bir çağrı bir organizasyon bağlar.

Yanıt, ilk eşitleme zaten çalışıyor halde neyin bağlandığını listeler. Akışın geri kalanının okuduğu iki alana kırpılmış hali:

{
  "success": true,
  "result": {
    "provider": "clickhouse",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Zaten bağlı olan bir hesap accounts yerine failures içine düşer, bu yüzden çağrıyı yinelemek asla bir bağlantıyı çoğaltmaz.

İlk eşitlemeyi bekle

Döndürülen her hesabı id değeriyle, status değeri ready olana kadar yokla (kayıtta new, kaynaklar akarken syncing):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Başarısız bir bağlama işi askıda bırakmak yerine başarısız kılsın diye döngüye bir son tarih ver. Hesap ready olduğunda kaynakları topolojidedir ve Polylane ilk kontrolünü başlatmıştır.

API'den bağlantıyı kes

Bağlantıyı silmek her eşitlemeyi ve kontrolü durdurur ve Polylane'in tuttuğu kimlik bilgilerini siler. Çağrı cloud_accounts:delete kapsamını gerektirir:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Sonra ClickHouse Cloud kimlik bilgisini, aşağıda Bağlantıyı kesme altında anlatıldığı gibi sağlayıcı tarafında iptal et.