ניהול חיבורים למקורות נתונים
תוכל ליצור, לעדכן, להסיר ולשתף חיבורים למקורות נתונים. כמשתמש של Oracle Analytics בעל גישה של מחבר תוכן המחשת נתונים, תוכל לבצע את הפעולות הבאות.
נושאים:
עריכת חיבור למקור נתונים
תוכל לעדכן פרטי חיבור של מקור נתונים.
אם אתה עורך חיבור SSL למסד נתונים של Oracle ועליך להשתמש בקובץ cwallet.sso חדש, לחץ בשדה ארנק לקוח לחץ על בחר כדי לחפש את הקובץ cwallet.sso. בקש מהמנהלן שלך את המיקום של הקובץ cwallet.sso.
מחיקת חיבור למקור נתונים
תוכל להסיר חיבור למקור נתונים מ-Oracle Analytics Cloud. לדוגמה, עליך למחוק חיבור למסד נתונים וליצור חיבור חדש כאשר סיסמת מסד הנתונים משתנה.
אם החיבור מכיל סלי נתונים, עליך למחוק אותם לפני שתוכל למחוק את החיבור.
- עבור לדף נתונים ובחר את חיבורים.
- רחף מעל לחיבור שאתה רוצה למחוק. מימין לחיבור המודגש, לחץ על פעולות ולאחר מכן בחר את מחק.
- לחץ על כן.
שיתוף חיבור למקור נתונים
אתה יכול להקצות הרשאות גישה לחיבורים למקורות נתונים שאתה יוצר או מנהל.
אפשרויות התחברות למסד נתונים
כאשר מגדירים פרטי התחברות באמצעות תיבת הדו-שיח 'יצירת התחברות' או תיבת הדו-שיח 'בחן', לכמה סוגים של מסד נתונים יש אפשרויות תצורה נוספות.
אפשרויות כלליות
- כאשר יוצרים חיבורים אל Oracle Databases, אפשר להתחבר בשתי דרכים באמצעות האפשרות סוג חיבור:
- בסיסי - ציין את המארח, היציאה, ואת שם השירות של מסד הנתונים.
- מתקדם - בשדה מחרוזת התחברות ציין את המזהה של שם גישת לקוח יחיד (SCAN) של מסדי הנתונים הרצים באשכול RAC. לדוגמה:
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)))
-
אפשר שעתוק בצובר - אם אתה טוען סל נתונים לחוברת עבודה, יש להשבית אפשרות זו ותוכל להתעלם ממנה. אפשרות זו שמורה לאנליסטים של נתונים ולמשתמשים מתקדמים לשכפול נתונים ממסד נתונים אחד למסד נתונים אחר.
אפשרויות אימות
- תמיד השתמש בפרטי אימות אלו - Oracle Analytics תמיד משתמש בסיסמת ושם ההתחברות שאתה מספק עבור החיבור. משתמשים אינם מונחים להתחבר.
- דרוש ממשתמשים להזין שם משתמש וסיסמה - Oracle Analytics מנחה את המשתמשים להזין את שם המשתמש והסיסמה שלהם בשביל מקור הנתונים. משתמשים יכולים לגשת רק אל הנתונים שאליהם יש להם הרשאות והקצאות תפקיד.
- (מוצג אם Oracle Analytics תומך בהתחזות בשביל סוג זה של מסד נתונים) השתמש בפרטי האימות של המשתמש הפעיל - Oracle Analytics לא מנחה משתמשים להתחבר כדי לגשת לנתונים. פרטי האימות שהם הזינו כדי להתחבר ל-Oracle Analytics משמשים גם לגישה למקור נתונים זה.
חיבור למערכת
לחץ על העתק, כדי להעתיק את מזהה אובייקט של החיבור. בוני מודל עסקי יכולים להדביק את מזהה אובייקט כדי לזהות ולהשתמש בחיבור נתונים ב-Model Administration Tool (תיבת הדו-שיח 'מאגר חיבורים').
הערה: אם לא תלחץ על התחברות למערכת כשתיצור לראשונה את החיבור, ואם תרצה אחר כך שבוני מודל הנתונים ישתמשו בפרטי החיבור, עליך ליצור חיבור חדש ולבחור התחברות למערכת. במילים אחרות, לא תוכל לערוך את החיבור יותר מאוחר ולבחור אפשרות זו.
הגבלות חיבור מסד נתונים
הבן את דרישות החיבור למסד הנתונים שלך לפני שתיצור את החיבור למסד הנתונים.
המספר המרבי של טבלאות מסד נתונים המוצג ב-Oracle Analytics הוא 10,000. אם תזדקק לטבלאות נוספות, Oracle ממליצה לבקש ממנהלן מסד הנתונים שלך שיצור משתמש מסד נתונים עם גישה לאובייקטים הספציפיים שאותם תרצה לנתח, ולציין את פרטי אימות המשתמש הללו בעת יצירת החיבור למסד הנתונים.
התחבר לנתונים עם אותיות רישיות, קטנות או מעורבות
אם אתה מתחבר למסד נתונים של Oracle, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server או My SQL, תוכל לשנות את מזהה המירכאות המוגדר כברירת מחדל כך שתוכל לקרוא נתונים עם אותיות רישיות, קטנות או מעורבות בשמות הטבלאות או העמודות.
select "EfG_Field" from "AbCd"; במקום לבנפיק את המשפט select EfG_Field from AbCd;, (שהיה נכשל).- לחץ על מתקדם, ולאחר מכן השתמש באפשרות של מזהים במירכאות, לבחירת המזהים במירכאות המשמשים במסד הנתונים.
לדוגמה, תוכל לבחור מירכאות כפולות (" "). Oracle Analytics מוסיפה מירכאות כפולות למשפט ה-SQL הבסיסיבחר "EfG_Field" מ-"AbCd";במקום להנפיקבחר EfG_Field מ-"AbCd;.הערה :
לא תראה את האפשרות מתקדם אם החיבור נוצר כאשר האפשרות חיבור מערכת נבחרה. אפשרויות מתקדמות אינן נתמכות בשביל חיבורי מערכת.
נהל חיבורים באמצעות ממשקי REST API
אתה יכול להשתמש בממשקי REST API של Oracle Analytics Cloud כדי לנהל באופן פרוגרמטי חיבורים למגוון מקורות נתונים. לדוגמה, ייתכן שתרצה ליצור תסריט שיוצר (או משנה) את אותו סל חיבורים בסביבות הבדיקות ובסביבות המסחריות של Oracle Analytics Cloud.
אודות ממשקי REST API של חיבור
אתה יכול ליצור, לעדכן ולמחוק חיבורים למגוון מקורות נתונים באמצעות ממשקי REST API. נושא זה מפרט את סוגי חיבורי מקור הנתונים שתוכל לנהל עם ממשקי REST API.
הערה :
REST API for Oracle Analytics Cloud מספק מידע מפורט על כל REST API. ראהנקודות קצה REST של חיבור.מקורות נתונים נתמכים
- מסד נתונים של Oracle
- Oracle Autonomous Data Warehouse
- Oracle Essbase
- MySQL
- PostgreSQL
- Snowflake
- SQL Server
- Vertica
פרמטרי חיבור
פרמטרי החיבור הנדרשים לכל מקור נתונים שונים. אם ברצונך להשתמש ב- REST API כדי ליצור או לעדכן חיבור, עליך לדעת את פורמט המסר של JSON הנדרש למקור הנתונים שלך. ראה מסרי JSON לדוגמה בשביל מקורות נתונים.
תהליך עבודה טיפוסי לניהול חיבורים באמצעות ממשקי REST API
להלן המשימות הנפוצות להתחלת השימוש בממשקי REST API של Oracle Analytics Cloud לניהול תוכניתי של חיבורים. אם אתה משתמש בממשקי REST API בפעם הראשונה, בצע את המשימות האלו כמדריך.
| משימה | תיאור | תיעוד של REST API |
|---|---|---|
| הבנת הדרישות המוקדמות |
הבנה והשלמה של מספר משימות כדרישות מוקדמות. אתה חייב להיות בעל הרשאות ליצור חוברות עבודה ולהתחבר לנתונים ב-Oracle Analytics Cloud כדי לנהל חיבורי נתונים באמצעות ממשקי REST API (מחבר תוכן DV). |
דרישות מוקדמות |
| הבנת אימות זהות עם אסימון OAuth 2.0 | אימות הזהות והענקת הרשאות ב-Oracle Analytics Cloud מנוהלים באמצעות Oracle Identity Cloud Service. על מנת לגשת אל ממשקי REST API של Oracle Analytics Cloud, חייב להיות לך אסימון גישה OAuth 2.0 שבו תשתמש להענקת הרשאות. | אימות זהות עם אסימון OAuth 2.0 |
| הבן מקורות נתונים נתמכים | קרא את הנושא המתאר את סוגי חיבורי הנתונים שאתה יכול לנהל עם ממשקי API של REST. | מקורות נתונים נתמכים |
| קבע פורמטים של מסר JSON | קרא את הנושא המתאר את פורמט מסר ה-JSON בשביל מקור הנתונים שלך והשג את פרמטרי החיבור הנדרשים. | מסרי JSON לדוגמה בשביל מקורות נתונים |
| צור חיבור | צור חיבור נתונים לשימוש בחוברות עבודה, דוחות ולוחות מידע. | צור חיבור (תצוגה מקדימה) |
| עדכן חיבור | עדכן מאפיין אחד או יותר של חיבור נתונים קיים. | עדכן חיבור (תצוגה מקדימה) |
| מחק חיבור | מחק חיבור נתונים. | מחק חיבור (תצוגה מקדימה) |
כיצד להשתמש בממשקי REST API לניהול חיבורי מקור נתונים
השתמש בדגימות ודוגמאות אלו כדי לעזור לך לנהל חיבורי מקור נתונים עם בקשות REST API באמצעות cURL.
פורמט cURL לדוגמה
-
JSON פשוט
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>"
-
<אסימון> - אסימון נושא OAuth 2.0 נדרש לאימות קריאות לממשקי REST API של Oracle Analytics Cloud. ראה אימות זהות עם אסימון OAuth 2.0.
-
<שם מארח> - מארח שבו פועל Oracle Analytics Cloud.
-
<מסר חיבור למקור נתונים> - פרטי התחברות ספציפיים למקור נתונים. ראה מסרי JSON לדוגמה בשביל מקורות נתונים.
-
<קובץ ארנק אבטחה> - מאחסן מידע הקשור ל-SSL כגון אימות זהות ואישורי חתימה, מפתחות פרטיים, אישורים ואישור אמין. נדרש לסוגי חיבור מסוימים, כגון Oracle Database עם SSL ו-Oracle Autonomous Data Warehouse (TLS הדדי).
דוגמאות
הדוגמאות הבאות מראות לך כיצד ליצור חיבור ל-Oracle Autonomous Data Warehouse (ADW).
- דוגמה 1 - צור חיבור ללא ארנק (TLS) ל-Oracle ADW
- דוגמה 2 - צור חיבור ל-Oracle ADW שמשתמש בקובץ ארנק אימותים
cwallet.sso(TLS הדדי)
דוגמאות נוספות זמינות במדריך REST API for Oracle Analytics Cloud. ראה צור חיבור (תצוגה מקדימה), עדכן חיבור (תצוגה מקדימה) ו-מחק חיבור (תצוגה מקדימה).
הערה :
מסרים של JSON בדוגמאות אלו הם ספציפיים ל-Oracle ADW. פורמט מסר ה-JSON שונה ממקורות נתונים אחרים. ראה מסרי JSON לדוגמה בשביל מקורות נתונים נתמכים.
דוגמה 1 - צור חיבור ללא ארנק (TLS) ל-Oracle ADW
oracle_adw_walletless. גוף הבקשה כולל JSON פשוט application/json.
curl
--כותרת "הרשאה: <token> נושא"
--כותרת "סוג תוכן: application/json"
--בקשת POST https://example.com/api/20210901/catalog/connections
--נתונים "{
"גרסה": "2.0.0",
"סוג": "חיבור",
"שם": "oracle_adw_walletless",
"תיאור": "חיבור Oracle ADW לדוגמה ללא ארנק שנוצר באמצעות API של חיבורים",
"תוכן": {
"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"
}
}
}"גוף התשובה
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
רשום את ה-connectionId המקודד ב-Base64 בגוף התגובה. מאוחר יותר, תוכל להשתמש בערך זה כדי לעדכן או למחוק את החיבור.
דוגמה 2 - צור חיבור ל-Oracle ADW שמשתמש בקובץ ארנק אימותים (TLS הדדי)
oracle_adw_with_wallet. גוף הבקשה כולל multipart/form-data, כלומר דורש גם קובץ ארנק מ-Oracle ADW (cwallet.sso) וגם פרמטרי חיבור של Oracle ADW.
curl
--כותרת "Authorization: Bearer <token>"
-–בקשת POST https://<hostname>/api/20210901/catalog/connections
--טופס "cert=@"/Users/scott/Downloads/Wallet_adw/cwallet.sso""
--טופס "connectionParams= "{
"גרסה": "2.0.0",
"סוג": "חיבור",
"שם": "oracle_adw_with_wallet",
"תיאור": "חיבור Oracle ADW לדוגמה עם ארנק נותר באמצעות חיבורי API",
"תוכן": {
"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"
}
}
}"גוף התשובה
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
רשום את ה-connectionId המקודד ב-Base64 בגוף התגובה. מאוחר יותר, תוכל להשתמש בערך זה כדי לעדכן או למחוק את החיבור.
מסרי JSON לדוגמה בשביל מקורות נתונים
כדי להתחבר למקור נתונים אתה מספק פרמטרים של חיבור. כאשר אתה משתמש ב-REST API של חיבורים, עליך לציין פרמטרים של חיבור בפורמט מסר של JSON. השתמש בטבלה זו כדי לקבוע את מסר ה-JSON למקור הנתונים שאליו ברצונך להתחבר.
| מקור נתונים | סוג בקשה | מסר קלט |
|---|---|---|
|
Oracle Database (לא-SSL) |
application/json |
סוג חיבור בסיסי {
"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
}
}
}
סוג חיבור מתקדם {
"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
}
}
} |
|
Oracle Databaseעם SSL |
ריבוי חלקים/נתוני טופס |
cwallet.sso (client credentials file) סוג חיבור בסיסי 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 Autonomous Data Warehouse - ללא ארנק (TLS) |
application/json |
סוג חיבור בסיסי {
"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 Autonomous Data Warehouse - ארנק (TLS הדדי) |
ריבוי חלקים/נתוני טופס |
cwallet.sso (client credentials file) סוג חיבור בסיסי 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) |
application/json |
סוג חיבור בסיסי {
"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
}
}
} |
|
PostgreSQL עם SSL |
application/json |
סוג חיבור בסיסי {
"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 (לא-SSL) |
application/json |
סוג חיבור בסיסי {
"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
}
}
} |
| שרת SQL עם SSL | application/json |
סוג חיבור בסיסי {
"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) |
application/json |
סוג חיבור בסיסי {
"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
}
}
} |
| MySQL עם SSL | application/json |
סוג חיבור בסיסי {
"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 |
סוג חיבור בסיסי {
"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"
}
}
} |