Veri Kaynağı: Program Aracılığıyla ODBC Veri Kaynağını Yapılandırma

Bu konuda, Açık Veritabanı Bağlantısı (ODBC) veri kaynağı adlarını program aracılığıyla nasıl yapılandırabileceğiniz açıklanmaktadır. Bu, kullanıcıyı veri kaynaklarının adlarını belirtmek için ODBC Yöneticisi'ni veya diğer programları açıkça kullanmaya zorlamadan verilere erişme esnekliği sağlar.

Genellikle bir kullanıcı, ilişkili veritabanı yönetim sistemi (DBMS) bu işlemi destekliyorsa bir veri kaynağı oluşturmak için ODBC Yöneticisi çalıştırır.

ODBC Yöneticisi aracılığıyla bir Microsoft Access ODBC veri kaynağı oluştururken size iki seçenek verilir: var olan bir .mdb dosyasını seçebilir veya yeni bir .mdb dosyası oluşturabilirsiniz. MFC ODBC uygulamanızdan .mdb dosyası oluşturmanın programlı bir yolu yoktur. Bu nedenle, uygulamanız bir Microsoft Access veri kaynağına (.mdb dosya) veri yerleştirmenizi gerektiriyorsa, büyük olasılıkla ihtiyacınız olduğunda kullanabileceğiniz veya kopyalayabileceğiniz boş bir .mdb dosyası istiyorsunuz.

Ancak, birçok DBMS programlı veri kaynağı oluşturmaya izin verir. Bazı veri kaynakları veritabanları için bir dizin belirtimi tutar. Başka bir ifadeyle, bir dizin veri kaynağıdır ve veri kaynağındaki her tablo ayrı bir dosyada depolanır (dBASE söz konusu olduğunda, her tablo bir .dbf dosyasıdır). Microsoft Access ve SQL Server gibi diğer ODBC veritabanlarının sürücüleri, bir veri kaynağının oluşturulabilmesi için belirli ölçütlerin karşılanması gerekir. Örneğin, SQL Server ODBC sürücüsünü kullanırken bir SQL Server bilgisayarı oluşturmalısınız.

SQLConfigDataSource Örneği

Aşağıdaki örnekte ODBC API işlevi, Yeni Excel Veri Kaynağı adlı yeni bir Excel veri kaynağı oluşturmak için kullanılır ::SQLConfigDataSource :

SQLConfigDataSource(NULL,ODBC_ADD_DSN, "Excel Files (*.xls)",
                   "DSN=New Excel Data Source\0"
                   "Description=New Excel Data Source\0"
                   "FileType=Excel\0"
                   "DataDirectory=C:\\EXCELDIR\0"
                   "MaxScanRows=20\0");

Veri kaynağının aslında bir dizin (C:\EXCELDIR) olduğunu unutmayın; bu dizin mevcut olmalıdır. Excel sürücüsü, veri kaynakları olarak dizinleri ve tek tek tablolar olarak dosyaları (.xls dosya başına bir tablo) kullanır.

Tablo oluşturma hakkında daha fazla bilgi için bkz . Veri Kaynağı: Odbc Veri Kaynağında Program Aracılığıyla Tablo Oluşturma.

Aşağıdaki bilgiler, ::SQLConfigDataSource ODBC API işlevine geçirilmesi gereken parametreleri açıklar. ::SQLConfigDataSource kullanmak için Odbcinst.h başlık dosyasını eklemeniz ve Odbcinst.lib import kitaplığını kullanmanız gerekir. Ayrıca, Odbccp32.dll çalışma zamanında yolda olmalıdır (veya 16 bit için Odbcinst.dll).

ODBC Yöneticisi'ni veya benzer bir yardımcı programı kullanarak bir ODBC veri kaynağı adı oluşturabilirsiniz. Ancak, bazen kullanıcının ayrı bir yardımcı program çalıştırmasına gerek kalmadan erişim elde etmek için doğrudan uygulamanızdan bir veri kaynağı adı oluşturmak istenir.

ODBC Yöneticisi (genellikle Denetim Masası yüklüdür), Windows kayıt defterine (veya 16 bit için Odbc.ini dosyasına) girdiler koyarak yeni bir veri kaynağı oluşturur. ODBC Sürücü Yöneticisi, veri kaynağı hakkında gerekli bilgileri almak için bu dosyayı sorgular. Kayıt defterine hangi bilgilerin yerleştirilmesi gerektiğini bilmeniz önemlidir çünkü çağrıyla ::SQLConfigDataSource birlikte sağlamanız gerekir.

Bu bilgiler kullanılmadan ::SQLConfigDataSourcedoğrudan kayıt defterine yazılabilir, ancak bunu kullanan herhangi bir uygulama, Driver Manager'ın verilerini korumak için kullandığı geçerli tekniği kullanır. ODBC Sürücü Yöneticisi'nde daha sonraki bir düzeltme veri kaynakları hakkında kayıt tutma işlemini farklı bir şekilde uygularsa, bu tekniği kullanan tüm uygulamalar bozulur. Genellikle bir API işlevi sağlandığında kullanılması önerilir. Örneğin, işlevi kullanırsanız ::SQLConfigDataSource kodunuz 16 bitten 32 bite taşınabilir, çünkü işlev Odbc.ini dosyasına veya kayıt defterine doğru şekilde yazar.

SQLConfigDataSource Parametreleri

Aşağıda işlevin ::SQLConfigDataSource parametreleri açıklanmaktadır. Bilgilerin çoğu Visual C++ sürüm 1.5 ve üzeri ile sağlanan ODBC API Programcı Başvurusu'ndan alınmıştır.

İşlev Prototipi

BOOL SQLConfigDataSource(HWND hwndParent,UINT fRequest, LPCSTR lpszDriver, LPCSTR lpszAttributes);

Açıklamalar

Parametreler ve Kullanım

hwndParent
KULLANıCıdan yeni veri kaynağı hakkında ek bilgi almak için ODBC Sürücü Yöneticisi'nin veya belirli ODBC sürücüsünün oluşturduğu iletişim kutularının sahibi olarak belirtilen pencere. lpszAttributes parametresi yeterli bilgi sağlamazsa, bir iletişim kutusu görüntülenir. hwndParent parametresi NULL olabilir.

lpszDriver
Sürücü açıklaması. Bu, fiziksel sürücü adı (DLL) yerine kullanıcılara sunulan addır.

lpszAttributes
"keyname=value" biçimindeki özniteliklerin listesi. Bu dizeler, listenin sonunda iki ardışık null sonlandırıcı olacak şekilde, null sonlandırıcılarla ayrılır. Bu öznitelikler, öncelikle yeni veri kaynağının kayıt defterine giren varsayılan sürücüye özgü girdilerdir. Bu işlev için ODBC API başvurusunda belirtilmeyen önemli anahtarlardan biri, yeni veri kaynağının adını belirten "DSN" ("veri kaynağı adı"). Girdilerin geri kalanı yeni veri kaynağının sürücüsüne özgü. Sürücü, yeni değerleri kullanıcıya iletişim kutularıyla sorabileceğinden, çoğu zaman tüm girdileri sağlamak gerekmez. (Buna neden olması için hwndParent değerini NULL olarak ayarlayın.) Kullanıcıdan istenmemesi için varsayılan değerleri açıkça sağlamak isteyebilirsiniz.

ODBC Yöneticisi'ni kullanarak lpszDriver parametresinin sürücüsünün açıklamasını belirlemek için

1. ODBC Yöneticisi'ni çalıştırın.

2. Ekle'yi tıklatın.

Bu size yüklü sürücülerin listesini ve açıklamalarını verir. Bu açıklamayı lpszDriver parametresi olarak kullanın. Açıklamanın tamamını(örneğin, "Excel Dosyaları (*.xls)" gibi dosya adı uzantısını ve açıklamada varsa parantezleri de dahil olmak üzere kullandığınızı unutmayın.

Alternatif olarak, "ODBC Sürücüleri" kayıt defteri anahtarı (veya Odbcinst.ini'daki [ODBC Sürücüleri] bölümü) altında tüm sürücü girdilerinin ve açıklamalarının listesini içeren kayıt defterini (veya 16 bit için dosya Odbcinst.ini) inceleyebilirsiniz.

lpszAttributes parametresinin anahtar adlarını ve değerlerini bulmanın bir yolu, önceden yapılandırılmış bir veri kaynağının (odbc yöneticisi tarafından yapılandırılmış olabilir) Odbc.ini dosyasını incelemektir.

lpszAttributes parametresinin anahtar adlarını ve değerlerini bulmak için

1. Windows kayıt defteri düzenleyicisini çalıştırın (veya 16 bit için Odbc.ini dosyasını açın).

2. Aşağıdakilerden birini kullanarak ODBC veri kaynakları bilgilerini bulun:

   • 32 bit için, sol bölmede HKEY_CURRENT_USER\Software\ODBC\ODBC.INI\ODBC Veri Kaynakları anahtarını bulun.

     Sağ bölmede, formdaki girişler listelenir: "pub: REG_SZ:<veri kaynağı adı>". Burada <veri kaynağı adı>, kullanmak istediğiniz sürücü için istenen ayarlarla zaten yapılandırılmış bir veri kaynağıdır. sql server gibi istediğiniz veri kaynağını seçin. "pub:" dizesini izleyen öğeler sırasıyla lpszAttributes parametrenizde kullanılacak anahtar adı ve değerdir.

   • 16 bit için Odbc.ini dosyasında [<veri kaynağı adı>] ile işaretlenmiş bölümü bulun.

     Bu satırı izleyen satırlar "keyname=value" biçimindedir. Bunlar tam olarak lpszAttributes parametrenizde kullanılacak girdilerdir.

Kullanacağınız sürücüye ilişkin belgeleri de incelemek isteyebilirsiniz. Yararlı bilgileri, ODBC Yöneticisi'ni çalıştırarak erişebileceğiniz sürücü için çevrimiçi Yardım'da bulabilirsiniz. Bu Yardım dosyaları genellikle Windows NT, Windows 3.1 veya Windows 95 için WINDOWS\SYSTEM dizinine yerleştirilir.

ODBC sürücünüz için çevrimiçi Yardım almak için

1. ODBC Yöneticisi'ni çalıştırın.

2. Ekle'yi tıklatın.

3. Sürücü adını seçin.

4. Tamam'a tıklayın.

ODBC Yöneticisi söz konusu sürücü için yeni veri kaynağı oluşturma bilgilerini görüntülediğinde Yardım'a tıklayın. Bu, genellikle sürücünün kullanımıyla ilgili önemli bilgiler içeren ilgili sürücü için Yardım dosyasını açar.

Ayrıca bkz.

Veri Kaynağı (ODBC)