ניהול חיבורים למקורות נתונים
תוכל ליצור, לעדכן, להסיר ולשתף חיבורים למקורות נתונים. כמשתמש של Oracle Analytics בעל גישה של מחבר תוכן המחשת נתונים, תוכל לבצע את הפעולות הבאות.
נושאים:
עריכת חיבור למקור נתונים
תוכל לעדכן פרטי חיבור של מקור נתונים.
אם אתה עורך חיבור SSL ל-Oracle AI Database ועליך להשתמש בקובץ 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.
- אם אתה מיידל נתונים באמצעות בונה מודלים סמנטיים, בחירה באפשרות זו מאפשרת לבונה מודלים סמנטיים להתחבר למקור הנתונים. כדי לגלות באילו מסדי נתונים תומך בונה המודלים הסמנטיים, חפש 'כן' בעמודה 'השתמש בבונה מודלים סמנטיים' ברשימת מקורות הנתונים הנתמכים. ראה מקורות נתונים נתמכים.
- אם אתה ממדל נתונים באמצעות ב-Model Administration Tool, אתה יכול להתחבר למקורות נתונים מסוימים על-ידי העתקת פרטי החיבור מ-Oracle Analytics Cloud אל Model Administration Tool. כדי לגלות אילו מקורות נתונים תומכים בכך, חפש את חיבור מערכת באפשרויות הקישוריות בשימוש ב-Model Administration Tool ב-מקורות נתונים נתמכים. לחץ על העתק, כדי להעתיק את מזהה אובייקט של החיבור. בוני מודל עסקי יכולים להדביק את מזהה אובייקט כדי לזהות ולהשתמש בחיבור נתונים ב-Model Administration Tool (תיבת הדו-שיח 'מאגר חיבורים').
הערה: אם לא תלחץ על התחברות למערכת כשתיצור לראשונה את החיבור, ואם תרצה אחר כך שבוני מודל הנתונים ישתמשו בפרטי החיבור, עליך ליצור חיבור חדש ולבחור התחברות למערכת. במילים אחרות, לא תוכל לערוך את החיבור יותר מאוחר ולבחור אפשרות זו.
הגבלות חיבור מסד נתונים
הבן את דרישות החיבור למסד הנתונים שלך לפני שתיצור את החיבור למסד הנתונים.
המספר המרבי של טבלאות מסד נתונים המוצג ב-Oracle Analytics הוא 10,000. אם תזדקק לטבלאות נוספות, Oracle ממליצה לבקש ממנהלן מסד הנתונים שלך שיצור משתמש מסד נתונים עם גישה לאובייקטים הספציפיים שאותם תרצה לנתח, ולציין את פרטי אימות המשתמש הללו בעת יצירת החיבור למסד הנתונים.
התחבר לנתונים עם אותיות גדולות, קטנות או מעורבות
אם אתה מתחבר למסד נתונים של Oracle, Oracle Autonomous AI Lakehouse , Oracle Autonomous AI 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 Database ו-Oracle AI Database
- בית אגם הנתונים האוטונומי לבינה מלאכותית של Oracle
- 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 AI Database עם SSL ו-Oracle Autonomous AI Lakehouse (TLS הדדי).
דוגמאות
הדוגמאות הבאות מראות לך כיצד ליצור חיבור ל-Oracle Autonomous AI Lakehouse (ALK).
- דוגמה 1 - צור חיבור ללא ארנק (TLS) ל-Oracle ALK
- דוגמה 2 - צור חיבור ל-Oracle ALK שמשתמש בקובץ ארנק פרטי אימות
cwallet.sso(TLS הדדי)
הערה :
מסרים של JSON בדוגמאות אלו הם ספציפיים ל-Oracle ALK. פורמט מסר ה-JSON שונה ממקורות נתונים אחרים. ראה מסרי JSON לדוגמה בשביל מקורות נתונים.דוגמה 1 - צור חיבור ללא ארנק (TLS) ל-Oracle Autonomous AI Lakehouse
oracle_ALK_walletless. גוף הבקשה כולל JSON פשוט application/json.
curl
--כותרת "הרשאה: נושא <token>"
--כותרת "סוג תוכן: יישום/json"
--בקשת POST https://example.com/api/20210901/catalog/connections
--נתונים "{
"גרסה": "2.0.0",
"סוג": "חיבור",
"שם": "oracle_ALK_walletless",
"תיאור": "חיבור לדוגמה של Oracle ALK ללא wallet שנוצר באמצעות 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_ALKwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes))")",
"שם משתמש": "ADMIN",
"סיסמה": "<<password>>",
"systemConnection": false,
"remoteData": false,
"sslType": "ServerSideSSL"
}
}
}"גוף התשובה
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
רשום את ה-connectionId המקודד ב-Base64 בגוף התגובה. מאוחר יותר, תוכל להשתמש בערך זה כדי לעדכן או למחוק את החיבור.
דוגמה 2: צור חיבור ל-Oracle ALK שמשתמש בקובץ ארנק (TLS הדדי)
oracle_ALK_with_wallet. גוף הבקשה כולל multipart/form-data, כלומר דורש גם קובץ ארנק מ-Oracle ALK (cwallet.sso) וגם פרמטרי חיבור של Oracle ALK.
curl
--כותרת "Authorization: Bearer <token>"
-–בקשת POST https://<hostname>/api/20210901/catalog/connections
--form "cert=@"/Users/scott/Downloads/Wallet_ALK/cwallet.sso""
--form "connectionParams= "{
"גרסה": "2.0.0",
"סוג": "חיבור",
"שם": "oracle_ALK_with_wallet",
"תיאור": "חיבור לדוגמה של Oracle ALK עם wallet שנוצר באמצעות 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_walletALK_high.ALKc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))",
"שם משתמש": "ADMIN",
"סיסמה": "<<password>>",
"remoteData": "false",
"systemConnection": false,
"sslType": "ClientSideSSL"
}
}
}"גוף התשובה
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
רשום את ה-connectionId המקודד ב-Base64 בגוף התגובה. מאוחר יותר, תוכל להשתמש בערך זה כדי לעדכן או למחוק את החיבור.
דוגמאות נוספות זמינות במדריך REST API for Oracle Analytics Cloud. ראה צור חיבור, עדכן חיבור וגם מחק חיבור.
מסרי JSON לדוגמה בשביל מקורות נתונים
כדי להתחבר למקור נתונים אתה מספק פרמטרים של חיבור. כאשר אתה משתמש ב-REST API של חיבורים, עליך לציין פרמטרים של חיבור בפורמט מסר של JSON. השתמש בטבלה זו כדי לקבוע את מסר ה-JSON למקור הנתונים שאליו ברצונך להתחבר.
| מקור נתונים | סוג בקשה | מסר קלט |
|---|---|---|
|
מסד נתוני בינה מלאכותית של Oracle (לא-SSL) |
application/json |
סוג חיבור בסיסי {
"version": "2.0.0",
"type": "connection",
"name": "oracle_db_non_ssl_basic",
"description": "Sample non-SSL Oracle AI 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 AI 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 AI 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 AI 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 AI Lakehouse - ללא ארנק (TLS) |
application/json |
סוג חיבור בסיסי {
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_walletless_basic",
"description": "Sample Oracle ALK 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 AI Lakehouse - ארנק (TLS הדדי) |
ריבוי חלקים/נתוני טופס |
cwallet.sso (client credentials file) סוג חיבור בסיסי cert: <cwallet.sso file location>
connectionParams: {
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_with_wallet",
"description": "Sample Oracle ALK 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"
}
}
} |