SAP HANA Veritabanı Bağlayıcısı

Kategori: Veritabanı Bağlayıcıları

Giriş

Bu doküman, bir mindzieDataDesigner bağlayıcısının SAP HANA veritabanına nasıl kurulacağını anlatmak için hazırlanmıştır. mindzieDataDesigner, mindzieStudio tarafından veritabanı tablolarını süreç madenciliği olay kayıtlarına dönüştürmek için kullanılan ETL aracıdır. Bu dokümanın amacı, bağlantı dizesinin oluşturulmasına ve gerekirse güvenlik duvarında portların açılmasına yardımcı olmaktır.

Genel Bakış

SAP HANA bağlayıcısı, SAP HANA veritabanlarına sağlam bağlantı sağlamak için ODBC kullanır. Bu bağlayıcı, kurumsal SAP ortamları için optimize edilmiştir ve kurum içi (on-premise) SAP HANA örneklerini destekleyerek, büyük ölçekli kurumsal verilerin süreç madenciliği için ideal bir çözümdür.

Sistem Gereksinimleri

  • Veritabanı Sistemi: SAP HANA 1.0 veya daha yeni (2.0 önerilir)
  • Yaygınlaştırma Seçenekleri: Kurum içi (On-premise)
  • ODBC Sürücüsü: SAP HANA ODBC Sürücüsü (en az sürüm 2.4)

Ön Koşullar

SAP HANA ODBC sürücüsü sisteminize kurulmuş olmalıdır. Kurulum talimatları için SAP dokümantasyonuna bakınız.

Bağlantı Dizisi Formatı

Temel ODBC Bağlantısı

Driver={HDBODBC};ServerNode=hostname:port;Database=database_name;UID=username;PWD=password;

Bağlantı Parametreleri

Parametre Açıklama Zorunlu Örnek
Driver ODBC sürücü adı Evet {HDBODBC} veya {SAP HANA ODBC Driver}
ServerNode HANA sunucu ve port Evet hana-server.company.com:30015
Database Hedef veritabanı/kiracı Hayır PRD veya SystemDB
UID Kullanıcı adı Evet MINDZIE_USER
PWD Şifre Evet SecurePassword123
CHAR_AS_UTF8 UTF-8 karakter işlemi Hayır 1
CONNECTTIMEOUT Bağlantı zaman aşımı Hayır 30
COMMUNICATIONTIMEOUT İletişim zaman aşımı Hayır 0 (sınırsız)
RECONNECT Otomatik yeniden bağlanma Hayır 1 (aktif)
ENCRYPT Şifrelemeyi etkinleştir Hayır true

Bağlantı Örnekleri

Standart Kurum İçi Bağlantı

Driver={HDBODBC};ServerNode=hana-prod.company.com:30015;Database=PRD;UID=PROCESS_MINING_USER;PWD=SecurePassword123;CHAR_AS_UTF8=1;

Çoklu Kiracı Veritabanı Konteyneri (MDC)

Driver={HDBODBC};ServerNode=hana-server:30013;Database=TENANT_DB;UID=MINDZIE_USER;PWD=password;

Yüksek Erişilebilirlik Bağlantısı

Driver={HDBODBC};ServerNode=hana-node1:30015,hana-node2:30015,hana-node3:30015;Database=PRD;UID=MINDZIE_USER;PWD=password;RECONNECT=1;

Gerekli SAP HANA İzinleri

Aşağıdaki SQL örnekleri, süreç madenciliği için tipik izinleri göstermektedir. Örnek şema, tablo ve kullanıcı isimlerini kendi değerlerinizle değiştirin:

-- Şema erişimi verme (PROCESS_MINING yerine kendi şema adınızı yazın)
GRANT SELECT ON SCHEMA "YOUR_SCHEMA_NAME" TO YOUR_USERNAME;

-- Tablo düzeyinde izin verme (gerçek tablo adlarınızla değiştirin)
GRANT SELECT ON "YOUR_SCHEMA_NAME"."YOUR_TABLE_NAME" TO YOUR_USERNAME;

-- Sistem görünümleri için (metadata erişimi gerekiyorsa)
GRANT SELECT ON SYS.M_DATABASES TO YOUR_USERNAME;

Örnek isimlerle:

-- Örnek izinler örnek isimlerle
GRANT SELECT ON SCHEMA "PROCESS_MINING" TO MINDZIE_USER;
GRANT SELECT ON "PROCESS_MINING"."EVENT_LOG" TO MINDZIE_USER;
GRANT SELECT ON SYS.M_DATABASES TO MINDZIE_USER;

ODBC Bağlantılarının Test Edilmesi

ODBC bağlantınızı yapılandırdıktan sonra aşağıdaki araçları kullanarak test edebilirsiniz:

Windows ODBC Veri Kaynağı Yöneticisi

  • Windows'a dahil (odbcad32.exe)
  • ODBC bağlantılarını yapılandırma ve test etme
  • Kontrol Paneli → Yönetim Araçları → ODBC Veri Kaynakları üzerinden erişilebilir

Veritabanı İstemci Araçları

  • DBeaver: Ücretsiz, çapraz platform veritabanı aracı, ODBC desteği ile
  • HeidiSQL: Windows tabanlı SQL istemcisi, ODBC bağlantılarını destekler
  • SQL Server Management Studio: SAP HANA'ya ODBC üzerinden bağlanabilir
  • Toad for SAP: Yerel SAP HANA desteği olan ticari araç

Microsoft Office Uygulamaları

  • Excel: Veri → Veri Al → Diğer Kaynaklardan → ODBC üzerinden bağlan
  • Power BI: Yerel SAP HANA bağlayıcısı ve ODBC desteği
  • Access: ODBC bağlantılarıyla tablo bağlantısı kurma

Komut Satırı Araçları

  • isql: Unix/Linux için ODBC bağlantı testi komut satırı aracı
  • osql/sqlcmd: Windows komut satırı araçları (SAP HANA desteği sınırlı)

Basit Test Sorgusu

Bağlandıktan sonra aşağıdaki temel sorgu ile test edin:

SELECT CURRENT_TIMESTAMP FROM SYS.DUMMY;

Güvenlik Duvarı Yapılandırması

Gerekli Güvenlik Duvarı Portları

SAP HANA ODBC bağlantıları için güvenlik duvarınızda aşağıdaki portların açılması gerekir:

Port Amaç Varsayılan Örnek (00)
30013 SystemDB SQL Bağlantısı Sistem veritabanı erişimi
30015 Kiracı Veritabanı SQL Bağlantısı İlk kiracı veritabanı
443 SAP HANA Cloud (HTTPS/SSL) Sadece bulut bağlantıları

Port Numaralandırma Şeması

  • Sistem Veritabanı: Port 30013 (varsayılan örnek 00 için)
  • Kiracı Veritabanı: Port 30015 (varsayılan örnek 00 için)
  • Desen: 3NN13 (SystemDB) veya 3NN15 (Tenant DB), burada NN = örnek numarası

Not: Port numaraları SAP HANA kurulumu sırasında özelleştirilebilir. Kullanmakta olduğunuz ortamda kullanılan portlar için SAP HANA yöneticinize danışın.

Ek Hususlar

  • Yüksek Erişilebilirlik: Küme yapılandırmaları için birden fazla port gerekebilir
  • Yük Dengeleyiciler: Yük dengeleyiciler için ek portlar gerekebilir

Referans: SAP Notu 2477204 - SSS: SAP HANA Hizmetleri ve Portlar (SAP destek erişimi gerektirir)

mindzie Sunucu Erişimi

Güvenliği artırmak için güvenlik duvarınızı sadece mindzie sunucularından gelen bağlantılara izin verecek şekilde yapılandırabilirsiniz; belirli IP adreslerini beyaz listeye alabilirsiniz. Kullandığınız mindzie sunucularının güncel IP adreslerini almak için mindzie destek ile iletişime geçin.

CDPOS Değişiklik Belgesi Çıkarımı

CDPOS, iş nesneleri üzerindeki alan düzeyindeki değişiklikleri tutan önemli bir SAP tablosudur ve süreç madenciliğinde detaylı değişikliklerin izlenmesi için sıkça kullanılır. CDPOS doğrudan tarih alanları içermediği için zaman bazlı filtreleme için CDHDR (Değişiklik Belgesi Başlığı) ile birleştirilmelidir.

Oracle Veritabanı Sorgusu

-- ORACLE SQL SÜRÜMÜ: SON 2 YILA AİT TÜM CDPOS KAYITLARINI AL
-- CDPOS tarih/saat alanı içermez - filtreleme için CDHDR ile birleştirilmeli

-- DOKÜMANTASYON REFERANSLARI:
-- 1. CDHDR.UDATE = "Değişiklik belgesinin oluşturulma tarihi" (SAP Veri Sayfası)
-- 2. CDPOS.CHANGENR = CDHDR.CHANGENR standart birleştirme (SAP Topluluğu)
-- 3. "Bu iki tablo değişiklik numarası ile bağlıdır" (Techlorean)
-- 4. CDHDR başlık bilgisi, CDPOS alan düzeyi detay içerir

SELECT CDPOS.*
FROM CDPOS
INNER JOIN CDHDR ON CDPOS.CHANGENR = CDHDR.CHANGENR
WHERE CDHDR.UDATE >= ADD_MONTHS(SYSDATE, -24)  -- Oracle: Son 24 ay (2 yıl)

-- ORACLE ÖZEL NOTLAR:
-- 1. 2 yıl için ADD_MONTHS(SYSDATE, -24) kullanılır
-- 2. SYSDATE geçerli tarih/zaman döner
-- 3. Alternatif: CDHDR.UDATE >= SYSDATE - INTERVAL '2' YEAR
-- 4. CDHDR.UDATE tarih formatı Oracle DATE türü ile uyumlu olmalı

SAP ODBC Sorgusu

-- SAP SQL VIA ODBC BAĞLAYICI: SON 2 YILA AİT TÜM CDPOS KAYITLARINI AL
-- CDPOS tarih/saat alanı içermez - filtreleme için CDHDR ile birleştirilmeli

-- DOKÜMANTASYON REFERANSLARI:
-- 1. CDHDR.UDATE = "Değişiklik belgesinin oluşturulma tarihi" (SAP Veri Sayfası)
-- 2. CDPOS.CHANGENR = CDHDR.CHANGENR standart birleştirme (SAP Topluluğu)
-- 3. "Bu iki tablo değişiklik numarası ile bağlıdır" (Techlorean)
-- 4. CDHDR başlık bilgisi, CDPOS alan düzeyi detay içerir

-- ÖNEMLİ: CDPOS bir küme tablosudur - doğrudan ODBC ile birleşim çalışmayabilir
-- SAP sürümüne bağlı olarak sorgu parçalanabilir

SELECT CDPOS.*
FROM CDPOS
INNER JOIN CDHDR ON CDPOS.CHANGENR = CDHDR.CHANGENR
WHERE CDHDR.UDATE >= ADD_DAYS(CURRENT_DATE, -730)  -- SAP HANA: Son 730 gün (2 yıl)

-- SAP SQL ÖZEL NOTLAR:
-- 1. 2 yıl hesaplaması için ADD_DAYS(CURRENT_DATE, -730) kullanılır (SAP HANA)
-- 2. Eski SAP sistemlerinde: CDHDR.UDATE >= '20220101' (sabit tarih)
-- 3. CDPOS küme tablosu olduğu için ODBC ile özel işleme gerekebilir
-- 4. Non-HANA için alternatif: Tarih çıkarma fonksiyonları destekleniyorsa kullanılır
-- 5. Tarih formatı: CDHDR.UDATE genellikle SAP'de YYYYMMDD formatında
-- 6. Maksimum uyumluluk için istemci tarafı tarih parametresi kullanın:
--    WHERE CDHDR.UDATE >= '?' -- 2 yıl önce tarihi için parametre

-- KÜME TABLOSUNA DİKKAT:
-- CDPOS, SAP'de küme tablosudur; ODBC bağlantılarında sorun çıkarabilir
-- Daha iyi performans için SAP RFC veya fonksiyon modülleri önerilir
-- Alternatif: Önce CDHDR sorgulanır, sonra CHANGENR değerleri ile CDPOS ayrı sorgulanır

SQL Server (T-SQL) Sorgusu

-- T-SQL (SQL SERVER) SÜRÜMÜ: SON 2 YILA AİT TÜM CDPOS KAYITLARINI AL
-- CDPOS tarih/saat alanı içermez - filtreleme için CDHDR ile birleştirilmeli

-- DOKÜMANTASYON REFERANSLARI:
-- 1. CDHDR.UDATE = "Değişiklik belgesinin oluşturulma tarihi" (SAP Veri Sayfası)
-- 2. CDPOS.CHANGENR = CDHDR.CHANGENR standart birleştirme (SAP Topluluğu)
-- 3. "Bu iki tablo değişiklik numarası ile bağlıdır" (Techlorean)
-- 4. CDHDR başlık bilgisi, CDPOS alan düzeyi detay içerir

SELECT CDPOS.*
FROM CDPOS
INNER JOIN CDHDR ON CDPOS.CHANGENR = CDHDR.CHANGENR
WHERE CDHDR.UDATE >= DATEADD(YEAR, -2, GETDATE())  -- T-SQL: Geçerli tarihten son 2 yıl

-- T-SQL ÖZEL NOTLAR:
-- 1. 2 yıl için DATEADD(YEAR, -2, GETDATE()) kullanılır
-- 2. GETDATE() geçerli tarih/zaman döner
-- 3. Alternatif: CDHDR.UDATE >= DATEADD(MONTH, -24, GETDATE())
-- 4. CDHDR.UDATE formatı SQL Server datetime ile uyumlu olmalı
-- 5. Eğer UDATE string olarak YYYYMMDD saklanıyorsa CONVERT() gerekebilir:
--    WHERE CONVERT(datetime, CDHDR.UDATE, 112) >= DATEADD(YEAR, -2, GETDATE())

ODBC Sürücü Kurulumu (Yalnızca mindzieStudio Sunucusu)

Not: Bu bölüm yalnızca mindzieStudio'nun çalıştığı sunucu için gereklidir.

İndir

Şuraya gidin: https://tools.hana.ondemand.com/#hanatools

  1. Gerekiyorsa ücretsiz bir SAP hesabı oluşturun (hızlı kayıt)
  2. Bulun: SAP HANA Client
  3. İndirin: Windows on x64 64bit sürümü
  4. Dosya adı: hanaclient-x.x.x.x-windows-x64.zip

Kurulum

  1. ZIP dosyasını açın
  2. hdbsetup.exe dosyasını Yönetici olarak çalıştırın
  3. "Install new SAP HANA client" seçeneğini seçin
  4. Kurulum sihirbazını takip edin (varsayılanları kabul edin)
  5. Kurulum tamamlandı!

Kurulumu Doğrulama

PowerShell'de çalıştırın:

Get-OdbcDriver | Where-Object {$_.Name -like "*HDB*"}

HDBODBC [64-bit] şeklinde sonuç görmelisiniz.

Kurulum Sonrası Sürücü Görünmüyorsa

cd "C:\Program Files\SAP\hdbclient"
hdbodbc_cons.exe -i

Sorun Giderme

Yaygın Bağlantı Sorunları

"Sunucuya bağlanılamıyor" Hatası

  • Sunucu adı ve port numarasını kontrol edin
  • Ağ bağlantısını ve güvenlik duvarı kurallarını kontrol edin
  • SAP HANA örneğinin çalıştığından ve bağlantıları kabul ettiğinden emin olun
  • HDB info komutuyla HANA servis durumunu kontrol edin

"Kimlik doğrulama başarısız" Hatası

  • Kullanıcı adı ve şifrenin doğru olduğundan emin olun
  • Kullanıcı hesabının kilitlenmediğini veya süresinin dolmadığını kontrol edin
  • Kullanıcının CONNECT yetkisi olduğundan emin olun
  • Şifre politikalarına uyulduğunu doğrulayın

"Sürücü bulunamadı" Hatası

  • SAP HANA Client içerisinde SAP HANA ODBC sürücüsünü kurun
  • Sürücünün ODBC Veri Kaynağı Yöneticisi'nde kayıtlı olduğundan emin olun
  • 32-bit ve 64-bit sürücü uyuşmazlığına dikkat edin
  • Sürücü yolunun sistem PATH değişkeninde olduğundan emin olun

"Tablo veya görünüm bulunamadı" Hatası

  • Tablo/görünüm isimlerini ve şema referanslarını kontrol edin
  • Kullanıcının ilgili nesneler için izinlerini kontrol edin
  • Nesneleri tam nitelikli isimle kullanın: SCHEMA.TABLE
  • Nesne isimlerinde büyük/küçük harf duyarlılığını doğrulayın

İlgili Bilgiler

Kaynaklar ve Referanslar

Bu doküman aşağıdaki kaynaklara dayanmaktadır:

Resmi SAP Dokümantasyonu

Topluluk ve Teknik Kaynaklar