Veri kaynaklarına bağlantılar oluşturabilir, güncelleyebilir, kaldırabilir ve paylaşabilirsiniz. DV İçerik Yazarı erişimine sahip bir Oracle Analitik kullanıcısı olarak bu eylemleri gerçekleştirebilirsiniz.
Konular:
Bir veri kaynağındaki verileri analiz etmek için bir bağlantı tanımlayın.
Veri kaynağının bağlantı detaylarını güncelleyebilirsiniz.
Oracle Veritabanı'nın SSL bağlantısını düzenliyorsanız ve yeni bir cwallet.sso
dosyası kullanmanız gerekiyorsa, İstemci Wallet alanında Seç'e tıklayıp cwallet.sso
dosyasına göz atın. Yöneticinizden cwallet.sso
dosyasının konumunu isteyin.
Oracle Analitik Bulutu'ndan bir veri kaynağı bağlantısını kaldırabilirsiniz. Örneğin, veritabanının parolası değiştiğinde veritabanı bağlantısını silmeniz ve yeni bir bağlantı oluşturmanız gerekir.
Bağlantı veri kümeleri içeriyorsa, bağlantıyı silebilmeniz için önce veri kümelerini silmeniz gerekir.
Oluşturduğunuz veya yönettiğiniz veri kaynağı bağlantılarına erişim izinleri atayabilirsiniz.
Bağlantı Oluştur iletişim kutusunu veya Denetle iletişim kutusunu kullanarak bağlantı detaylarını belirlerken bazı veritabanı tiplerinin ek konfigürasyon seçenekleri vardır.
Genel Seçenekler
sales.example.com =(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.111)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.222)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.333)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME= salesservice.example.com)))
Toplu Çoğaltmayı Etkinleştir - Çalışma kitabı için bir veri kümesi yüklüyorsanız bu seçenek kapalı olmalıdır ve seçeneği yok sayabilirsiniz. Bu seçenek veri analistleri ve gelişmiş kullanıcılar için verileri bir veritabanından diğerine çoğaltmak üzere ayrılmıştır.
Kimlik Doğrulama Seçenekleri
Sistem bağlantısı
Bağlantının Nesne No'sunu kopyalamak için Kopyala'ya tıklayın. İş modelleyicileri, Model Yönetim Aracı'nda (Bağlantı Havuzu iletişim kutusu) bir veri bağlantısını tanımlamak ve kullanmak için Nesne No'yu yapıştırabilir.
Not: Bağlantıyı ilk oluşturduğunuzda Sistem bağlantısı'na tıklamazsanız, daha sonra veri modelleyicilerin bağlantı detaylarını kullanmasını istiyorsanız, yeni bir bağlantı oluşturmanız ve Sistem bağlantısı'nı seçmeniz gerekir. Başka bir deyişle, bağlantıyı daha sonra düzenleyemez ve bu seçeneği belirleyemezsiniz.
Veritabanı bağlantısı oluşturmadan önce veritabanı bağlantı gereksinimlerinizi anlayın.
Oracle Analitik içinde görüntülenen maksimum veritabanı tablosu sayısı 10.000'dir. Ek tablolara ihtiyaç duyuyorsanız Oracle, veritabanı yöneticinizden analiz etmek istediğiniz belirli nesneler için erişimi olan bir veritabanı kullanıcısı oluşturmasını ve veritabanı bağlantısını oluşturduğunuzda kullanıcının kimlik bilgilerini belirtmesini istemenizi önerir.
Oracle veritabanına, Oracle Kendi Kendini Yöneten Veri Ambarı'na, Oracle Hareket İşleme'ye, Snowflake'e, SQL Server'a veya My SQL'e bağlanıyorsanız tablo veya sütun adlarındaki küçük, büyük veya küçük/büyük harf karışık karakterleri içeren verileri okuyabilmeniz için tırnak içine alma tanımlayıcısı öndeğerini değiştirebilirsiniz.
select EfG_Field" from "AbCd;
komutunu düzenlemek yerine (bu başarısız olur) altta yatan select "EfG_Field" from "AbCd";
SQL komutuna çift tırnak ekler.Bağlantıları programlı biçimde bir veri kaynakları aralığında yönetmek üzere Oracle Analitik Bulut Temsili Durum Transferi Uygulama Programı Arabirimlerini kullanabilirsiniz. Örneğin, hem test hem de üretim Oracle Analitik Bulutu ortamlarınızda aynı bağlantı kümesini oluşturan (veya değiştiren) bir komut listesi oluşturmak isteyebilirsiniz.
Temsili Durum Transferi Uygulama Programı Arabirimlerini kullanarak bir veri kaynakları aralığı için bağlantıları oluşturabilir, güncelleyebilir ve silebilirsiniz. Bu konuda, Temsili Durum Transferi Uygulama Programı Arabirimleri ile yönetebileceğiniz veri kaynağı bağlantısı tipleri listelenir.
Not:
Oracle Analitik Bulutu için REST Uygulama Programı Arabirimi, her REST Uygulama Programı Arabirimi hakkında detaylı bilgi sağlar. Bağlantı Temsili Durum Transferi Uç Noktaları konusuna bakın.Desteklenen Veri Kaynakları
Bağlantı Parametreleri
Her veri kaynağı için gereken bağlantı parametreleri farklıdır. Bir bağlantı oluşturmak veya güncellemek üzere Temsili Durum Transferi Uygulama Programı Arabirimi kullanmak istiyorsanız veri kaynağınız için gereken JSON veri yükü formatını bilmeniz gerekir. Veri Kaynakları İçin Örnek JSON Veri Yükleri konusuna bakın.
Bağlantıları programlı biçimde yönetmek üzere Oracle Analitik Bulut Temsili Durum Transferi Uygulama Programı Arabirimlerini kullanmaya başlamaya yönelik ortak görevler. Temsili Durum Transferi Uygulama Programı Arabirimlerini ilk kez kullanıyorsanız kılavuz olarak bu görevleri uygulayın.
Görev | Açıklama | REST API Dokümantasyonu |
---|---|---|
Ön koşulları anlama |
Birkaç ön koşul görevi anlayın ve tamamlayın. Temsili Durum Transferi Uygulama Programı Arabirimlerini kullanarak veri bağlantılarını yönetmek üzere Oracle Analitik Bulutu'ndaki verilere bağlanmak ve çalışma kitaplarını oluşturmaya ilişkin izinlere sahip olmalısınız (DV İçerik Yazarı). |
Ön Koşullar |
OAuth 2.0 jeton kimlik doğrulamasını anlama | Oracle Analitik Bulutu'nda kimlik doğrulama ve yetkilendirme, Oracle Kimlik Bulut Hizmeti tarafından yönetilir. Oracle Analitik Bulutu REST API'lerine erişmek için yetkilendirmede kullanmak üzere bir OAuth 2.0 erişim belirtecine ihtiyacınız vardır. | OAuth 2.0 Belirteci Kimlik Doğrulaması |
Desteklenen veri kaynaklarını anlama | Temsili Durum Transferi Uygulama Programı Arabirimleri ile yönetebileceğiniz veri bağlantısı tiplerini açıklayan konuyu okuyun. | Desteklenen Veri Kaynakları |
JSON veri yükü formatlarını belirleme | Veri kaynağınıza ilişkin JSON veri yükü formatını açıklayan konuyu okuyun ve gerekli bağlantı parametrelerini elde edin. | Veri Kaynakları İçin Örnek JSON Veri Yükleri |
Bir bağlantı oluşturma | Çalışma kitaplarında, raporlarda ve kumanda tablolarında kullanmak üzere bir veri bağlantısı oluşturun. | Bir bağlantı oluşturma (Önizleme) |
Bir bağlantıyı güncelleme | Mevcut bir veri bağlantısının bir veya daha fazla niteliğini güncelleyin. | Bir bağlantıyı güncelleme (Önizleme) |
Bir bağlantıyı silme | Bir veri bağlantısı silin. | Bir bağlantıyı silme (Önizleme) |
cURL kullanarak REST Uygulama Programı Arabirimi istekleriyle veri kaynağı bağlantılarını yönetmenize yardımcı olması için bu modelleri ve örnekleri kullanın.
Örnek cURL Formatı
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --data "<data source connection payload>"
curl --header "Authorization: Bearer <token>" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --form "cert=<security wallet file>" --form "connectionParams=<data source connection payload>"
<token> - Oracle Analitik Bulutu Temsili Durum Transferi Uygulama Programı Arabirimlerine yapılan çağrıları doğrulamak için gereken OAuth 2.0 taşıyıcı belirteci. OAuth 2.0 Belirteci Kimlik Doğrulaması konusuna bakın.
<hostname> - Oracle Analitik Bulutu'nun çalıştığı ana bilgisayar.
<veri kaynağı bağlantı veri yükü> - Veri kaynağına özgü bağlantı bilgileri. Veri Kaynakları İçin Örnek JSON Veri Yükleri konusuna bakın.
<güvenlik cüzdan dosyası> - kimlik doğrulama ve imzalama kimlik bilgileri, özel anahtarlar, sertifikalar ve güvenilir sertifika gibi SSL ile ilgili bilgileri depolar. Bazı bağlantı tipleri için gereklidir, örneğin SSL ile Oracle Veritabanı ve Oracle Kendi Kendini Yöneten Veri Ambarı (Karşılıklı TLS).
Örnekler
Şu örnekte Oracle Kendi Kendini Yöneten Veri Ambarı'na bir bağlantının nasıl oluşturulacağı gösterilmektedir.
cwallet.sso
(Karşılıklı TLS) kullanan bir Oracle ADW bağlantısı oluştururNot:
Bu örneklerdeki JSON veri yükleri Oracle ADW'ye özgüdür. JSON veri yükü formatı, diğer veri kaynaklarından farklı. Desteklenen Veri Kaynakları İçin Örnek JSON Veri Yükleri konusuna bakın.Örnek 1 Oracle ADW için cüzdansız bir (TLS) bağlantısı oluşturun
oracle_adw_walletless
adında bir bağlantı oluşturuyorsunuz. Talep gövdesi basit JSON application/json
içerir.
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST https://example.com/api/20210901/catalog/connections --data "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless", "description": "Sample Oracle ADW connection without a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_adwwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } }"
Yanıt Gövdesi
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Yanıt gövdesinde bir Base64 kodlanmış connectionId
notu oluşturun. Daha sonra, bağlantıyı güncellemek veya silmek için bu değeri kullanabilirsiniz.
Örnek 2 Oracle ADW için bir cüzdan dosyası kullanan bir bağlantı oluşturun (Karşılıklı TLS)
oracle_adw_with_wallet
adında bir bağlantı oluşturuyorsunuz. Talep gövdesi multipart/form-data
içerir. Hem Oracle Kendi Kendini Yöneten Veri Ambarından bir cüzdan dosyası (cwallet.sso
) hem de Oracle Kendi Kendini Yöneten Veri Ambarı bağlantı parametreleri gereklidir.
curl --header "Authorization: Bearer <token>" -–request POST https://<hostname>/api/20210901/catalog/connections --form "cert=@"/Users/scott/Downloads/Wallet_adw/cwallet.sso"" --form "connectionParams= "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Sample Oracle ADW connection with a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_walletadw_high.adwc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))", "username": "ADMIN", "password": "<<password>>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } }"
Yanıt Gövdesi
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Yanıt gövdesinde bir Base64 kodlanmış connectionId
notu oluşturun. Daha sonra, bağlantıyı güncellemek veya silmek için bu değeri kullanabilirsiniz.
Oracle Analitik Bulutu için REST Uygulama Programı Arabirimi'nde ek örnekler mevcuttur. Bir bağlantı oluşturma, Bir bağlantıyı güncelleme ve Bir bağlantıyı silme konularına bakın.
Veri kaynağına bağlanmak için bağlantı parametrelerini sağlarsınız. Bağlantılar REST Uygulama Programı Arabirimini kullandığınızda bağlantı parametrelerini JSON verisi formatında belirlersiniz. Bağlanmak istediğiniz veri kaynağına ilişkin JSON veri yükünü belirlemek üzere bu tabloyu kullanın.
Veri Kaynağı | İstek Tipi | Girdi Veri Yükü |
---|---|---|
Oracle Veritabanı (SSL Dışı) |
application/json |
Temel Bağlantı Tipi { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_basic", "description": "Sample non-SSL Oracle Database connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "1521", "serviceName": "orcl", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } Gelişmiş Bağlantı Tipi { "version": "2.0.0", "type": "connection", "name": "oracle_db_non_ssl_advanced ", "description": " Sample non-SSL Oracle Database connection created with the advanced connection string format using Connections API", "content": { "connectionParams": { "connectionString": "(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=example.com)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))", "username": "admin", "password": "<password>", "connectionType": "oracle-database", "remoteData": false, "systemConnection": false } } } |
SSL ile Oracle Veritabanı |
multi-part/form-data |
cwallet.sso (client credentials file) Temel Bağlantı Tipi cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_db_ssl", "description": "Sample Oracle Database connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-database", "host": "example.com", "port": "2484", "serviceName": "ORCLPDB1", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false } } } |
Oracle Kendi Kendini Yöneten Veri Ambarı - Cüzdansız (TLS) |
application/json |
Temel Bağlantı Tipi { "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless_basic", "description": "Sample Oracle ADW connection without a wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521) (host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "systemConnection": false, "remoteData": false, "sslType": "ServerSideSSL" } } } |
Oracle Kendi Kendini Yöneten Veri Ambarı - Cüzdan (Karşılıklı TLS) |
multipart/form-data |
cwallet.sso (client credentials file) Temel Bağlantı Tipi cert: <cwallet.sso file location> connectionParams: { "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Sample Oracle ADW connection with wallet created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse", "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))", "username": "admin", "password": "<password>", "remoteData": "false", "systemConnection": false, "sslType": "ClientSideSSL" } } } |
PostgreSQL (SSL Dışı) |
application/json |
Temel Bağlantı Tipi { "version":"2.0.0", "type": "connection", "name": "postgres_non_SSL", "description": "Sample PostgreSQL connection created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
SSL ile PostgreSQL |
application/json |
Temel Bağlantı Tipi { "version":"2.0.0", "type": "connection", "name": "postgres_SSL_Conn", "description": "Sample PostgreSQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "postgresql-database", "host": "example.com", "port": "5432", "serviceName": "postgres", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
SQL Server (SSL Dışı) |
application/json |
Temel Bağlantı Tipi { "version":"2.0.0", "type": "connection", "name": "SqlServer_non_ssl", "description": "Sample non-SSL SQL Server connection created using Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "1400", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
SSL ile SQL Server | application/json |
Temel Bağlantı Tipi { "version":"2.0.0", "type": "connection", "name": "SqlServer_ssl", "description": "Sample SQL Server connection with SSL created using the Connections API", "content": { "connectionParams": { "connectionType": "sqlserver-database", "host": "example.com", "port": "60190", "serviceName": "sqlserver1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
MySQL (SSL Dışı) |
application/json |
Temel Bağlantı Tipi { "version":"2.0.0", "type": "connection", "name": "MySql_no_SSL", "description": "Sample MySQL connection created using the Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3307", "serviceName": "mysql1", "username": "admin", "password": "<password>", "remoteData": false, "systemConnection": false } } } |
SSL ile MySQL | application/json |
Temel Bağlantı Tipi { "version":"2.0.0", "type": "connection", "name": "MySql_ssl", "description": "Sample MySQL connection with SSL created using Connections API", "content": { "connectionParams": { "connectionType": "mysql-database", "host": "example.com", "port": "3306", "serviceName": "mysql1", "username": "admin", "password": "<password>", "sslType":"ServerSideSSL", "remoteData": false, "systemConnection": false } } } |
Oracle Essbase |
application/json |
Temel Bağlantı Tipi { "version":"2.0.0", "type": "connection", "name": "Oracle_Essbase", "description": "Sample Oracle Essbase connection created using Connections API", "content": { "connectionParams": { "connectionType": "oracle-essbase", "dsn":"example.com", "username":"admin", "password":"<password>", "remoteData": false, "systemConnection": false, "authentication":"current"/"private"/"sso" } } } |