Мақсаты
Сақталған қосылым арқылы деректерді оқиды немесе жазады. Қолжетімді қасиеттер қызметке тәуелді: IBM Planning Analytics, UBC Analytics, файл қоймасы, дерекқор немесе API. Тіркелгі деректері қосылымның өзінде бапталады; блок нысан мен алмасу ережелерін таңдайды.
Кірістер және шығыстар
Дереккөздің кірістері жоқ, кестені out арқылы береді. Қабылдаушы in қабылдап, қосымша success және failure шығыстарына ие. success жазылған кестені, failure бір жолдық қате сипаттамасын береді. TurboIntegrator процесі үшін блок процесті бір рет немесе параметр бағандары мәндерінің әр бөлек тіркесіміне іске қосатын қабылдаушы болады.
Параметрлер
| Параметр | Баптаулар және мәндер | Нұсқалар және шектер |
|---|---|---|
role | Блок рөлі: дереккөз деректерді оқиды; қабылдаушы нәтижені жазады. | Нұсқалар: source, target |
connection_id | Блок жүйеге қатынайтын сақталған қосылым. | 64 таңбаға дейін |
object_type | Бизнес-жүйе нысанының түрі: куб, өлшем немесе пішін. IBM өлшемі дереккөз және қабылдаушы рөлдерін, UBC Analytics өлшемі дереккөз рөлін қолдайды. | Нұсқалар: cube, dimension, formӘдепкі: cube |
dimension | Элементтері оқылатын өлшем. | Әдепкі: empty256 таңбаға дейін |
hierarchy | Таңдалған өлшем иерархиясы. | Әдепкі: empty256 таңбаға дейін |
cube | Оқылатын немесе жазылатын куб. | Әдепкі: empty256 таңбаға дейін |
mapping | Кесте өрістерін куб өлшемдері мен мәніне кіріктірілген сәйкестендіру. | Әдепкі: not set |
environment | UBC Analytics ортасы; оны нысан мен өрістерден бұрын таңдаңыз. | Әдепкі: empty80 таңбаға дейін |
form | Оқылатын немесе жазылатын UBC Analytics пішіні. | Әдепкі: empty256 таңбаға дейін |
read_scope | Пішін үшін: барлық жазба немесе ағынды іске қосқан жазба. | Нұсқалар: all, launch_recordӘдепкі: all |
columns | Тек өрістерді немесе нысан кодтары/атауларын қоса, барлық қолжетімді бағанды оқу. | Нұсқалар: fields, allӘдепкі: fields |
write_mode | Пішін үшін: insert арқылы қосу, update арқылы жаңарту немесе upsert арқылы қосу/жаңарту. | Нұсқалар: insert, update, upsertӘдепкі: insert |
key_field | update/upsert кезінде жазбаны табуға арналған пішіннің кілт өрісі. | Әдепкі: empty256 таңбаға дейін |
form_mapping | Кіріс бағандарын, тұрақтыларды, параметрлерді, анықтамалық немесе жасалған мәндерді пішін өрістеріне сәйкестендіру. | Әдепкі: not set |
view | Ортақ IBM куб көрінісі; жеке көріністер қолдау таппайды. | Әдепкі: empty256 таңбаға дейін |
read_mode | Таңдалған көріністі немесе кубты оқу. | Нұсқалар: view, cubeӘдепкі: view |
element_mode | Барлық, тек жапырақ немесе тек біріктірілген өлшем элементтерін оқу. | Нұсқалар: leaf, consolidated, allӘдепкі: all |
value_column | Көрсеткіш мәні орналасқан кесте өрісі. | Әдепкі: Value256 таңбаға дейін |
file_kind | Үйлесімді қосылымдар үшін файл қызметінің түрі. | Нұсқалар: google_sheets, google_drive, onedrive, s3, ftp, network, agent_folderӘдепкі: google_drive |
selection_mode | Көрсетілген ұяшықтарды немесе жұмыс кітабының атаулы ауқымын оқу. | Нұсқалар: cells, defined_nameӘдепкі: cells |
defined_name | Excel жұмыс кітабында анықталған ауқым атауы. | Әдепкі: empty255 таңбаға дейін |
defined_scope | Атаулы ауқымның әрекет аясы: кітап немесе парақ. | Әдепкі: empty128 таңбаға дейін |
json_path | JSON құжатындағы жазбалар массивіне жол. | Әдепкі: empty1024 таңбаға дейін |
xml_path | XML жолдары ретінде оқылатын элементтерге жол. | Әдепкі: ./*1024 таңбаға дейін |
file_id | Таңдалған қоймадағы файл идентификаторы немесе жолы. | Әдепкі: empty2048 таңбаға дейін |
sheet | Жұмыс кітабының парақ атауы. | Әдепкі: empty128 таңбаға дейін |
range | A1 жазылымындағы ұяшық ауқымы, мысалы A1:F500. | Әдепкі: A1:M10040 таңбаға дейін |
header | Ауқымның алғашқы жолын өріс атаулары ретінде пайдалану. | Әдепкі: enabled |
delimiter | Мәтіндік файлдың өріс бөлгіші. | Нұсқалар: ,, ;, tabӘдепкі: ; |
clear_range | Жазудан кейін бапталған ауқымның қалған бөлігін тазалау; оның сыртындағы деректер өзгермейді. | Әдепкі: disabled |
target_mode | Нысанға деректер жазу немесе IBM TurboIntegrator процесін бастау. | Нұсқалар: write, processӘдепкі: write |
process | Қолжетімді тізімдегі TurboIntegrator процесінің атауы. | Әдепкі: empty256 таңбаға дейін |
process_parameters | Процесс параметрлері: тұрақты, іске қосу параметрі немесе кіріс деректер бағаны. | Саны: 0–100 |
external | Сыртқы қызмет, API немесе дерекқор кестесінің/сұрауының/ресурсының баптаулары. | Әдепкі: not set |
cube_write | Кубқа жазу әрекеті: қосу, алмастыру немесе транзакциялық үстеме; қажет болса жазудан бұрын тазалау. | Әдепкі: not set |
Кубқа сәйкестендіру және жазу
| Параметр | Баптау |
|---|---|
| mapping.bindings | Әр өлшем мен иерархия; баған/тұрақты/параметр көзі, мән, қосымша Alias және іздеу сәйкестендіруі. |
| mapping.value_column / value_type / decimal | Көрсеткіш өрісі, сан немесе мәтін, ондық бөлгіш. |
| mapping.blank / duplicates | Бос мәндер үшін skip/zero/error; қайталанатын координаттар үшін error/sum. |
| mapping.portion_cells / response_seconds | 500–50 000 ұяшық, әдепкі 10 000; 10–3600 секунд, әдепкі 120. |
| cube_write.mode | add, replace немесе transaction. Transaction режимі UBC Analytics пішінін сақтау оқиғасын пайдаланады. |
| cube_write.clear | Бүкіл куб немесе элементтер, деректер не параметрлер бойынша таңдалған кесінділер. Тазалау алмастыруды қолданады. |
Кестелер, API және сыртқы қызметтер
| Параметр | Нені баптайды |
|---|---|
external.object / source_mode / query | Оқылатын нысан немесе қызмет қолдаса, жеке сұрау. |
select / filter / order_by | Өрістер, таңдау шарты және рет; синтаксис қызметке тәуелді. |
write_mode / key_fields | Қолдау көрсетілетін жазу амалдары үшін insert/update/upsert және кілт өрістері. |
method / query_params / body / records_path | API үшін: GET/POST/PUT/PATCH, сұрау параметрлері, денесі және жауаптағы жолдарға жол. |
pagination / next_link_path | Беттеусіз, келесі бет сілтемесі, бет нөмірі немесе ығысу. next_link_path сілтеме жолын көрсетеді. |
page_param / size_param / page_size / first_page / max_pages | Бет параметрлерінің атаулары, өлшемі 1–10000, алғашқы бет 0/1 және ең көп бет саны 1–10000. |
send_mode / batch_size / batch_key | Әр жолды немесе топтаманы жіберу; топтама өлшемі және сұрау денесіндегі массив кілті. |
value_format / value_field / ttl | Үйлесімді кілт–мән қоймасы үшін: hash/json/string, мазмұн өрісі және секундпен сақтау уақыты (31536000-ға дейін). |
extra_params | Қолдау көрсетілетін қызметтің қосымша параметрлері; тек оның пішінінде көрсетілген қасиеттерді пайдаланыңыз. |
Қадамдық баптау
- «Қосылымдар» бөлімінде қосылым жасап, тексеріңіз. Оны палитрадан ағынға сүйреңіз.
- Рөлді таңдаңыз. Бизнес-жүйе үшін алдымен орта мен нысан түрін, содан кейін кубты, өлшемді, пішінді немесе процесті таңдаңыз.
- Дереккөз үшін оқу тәсілін; сыртқы қызмет үшін нысанды немесе сұрауды, таңдауды және өріс тізімін баптаңыз. Өрістерді оқыңыз.
- Қабылдаушыға дайын кестені қосыңыз. Сәйкестендіруді, жазу режимін және жаңарту кілттерін баптаңыз.
- Жазудан кейін орындау жалғасуы керек болса, success шығысын келесі қадамға, failure шығысын хабарға немесе басқа өңдеушіге жалғаңыз.
- Симуляция жүргізіп, координаттарды, жол санын және әсер ететін деректер ауқымын тексеріңіз, содан кейін жазуды бастаңыз.
Ережелер және диагностика
- Оқу/жазу мүмкіндіктерін нақты қызмет анықтайды; ортақ конфигурация өрісінің болуы әр қосылым барлық режимді қолдайды дегенді білдірмейді.
- Кубқа әр өлшем үшін мән және көрсеткіш өрісі қажет. Сәйкестендіру әдетте тікелей қабылдаушыда сақталады.
- UBC Analytics пішіндері кестелік сәйкестендіруді қабылдайды; оларға куб сәйкестендіруі мен TI орындауы қолданылмайды. update/upsert кілт өрісі сәйкестендіруден мән алуы керек.
- Симуляцияда TI процесі IBM ішінде тексеріледі, бірақ орындалмайды. Параметрдің бос тұрақты мәні процестің әдепкі мәнін білдіреді.
- failure шығысы қабылдаушының анық қатесін өңдейді. Сыртқы жазудың анықталмаған нәтижесі мен тоқтату күйді бөлек тексеруді талап етеді; жазу міндетті түрде болмады деп есептемеңіз.
Баптау мысалы
Жоспар жүктеу үшін IBM қосылымын, role=target және cube=SalesPlan таңдаңыз. Product пен Month өлшемдерін бағандарға, Version өлшемін Budget тұрақтысына, Measure өлшемін Amount мәніне, value_column мәнін Value өрісіне байланыстырыңыз. Мекенжайланған ұяшықтарды алмастыру үшін replace таңдаңыз; сәтті аяқталған соң нәтиже хабарын көрсетіңіз.
IBM өлшеміне жазу
Қабылдаушы үшін «Өлшем», өлшемнің өзі және иерархияны таңдаңыз. «Өлшемге жазу» бөлімінде негізгі атау бағанын көрсетіңіз. Жоқ сандық жапырақ элементтерін жасауға рұқсат беріңіз немесе анықтамалықты қатаң бақылау үшін оны өшіріңіз. Атрибутты жаңарту үшін оның атауын, мән бағанын және режимін таңдаңыз: тазаламай немесе алдымен барлық басқа мәнді тазалап. Бір элементтің қайталанатын жолдарында атрибут мәні бірдей болуы керек.
Біріктірілген ата-аналық элемент тұрақтыдан, іске қосу параметрінен немесе бағаннан алынуы мүмкін. Көпдеңгейлі құрылым үшін 20-ға дейін ата-аналық баған → еншілес баған жұбын қосыңыз. Жоқ ата-аналар біріктіру элементтері ретінде жасала алады; циклдер мен жарамсыз элемент түрлері қабылданбайды. Бар байланыстар жойылмайды. Симуляция IBM деректерін өзгертпей иерархияны оқып, тексереді; жазудан бұрын күй қайта тексеріледі. Куб сәйкестендіруінсіз кестені беріңіз.
Арнайы сценарийлер өрістері
| Параметр | Мынаны пайдаланыңыз: |
|---|---|
| simulation_record / simulation_previous | Симуляцияда қолданылатын пішін жазбасы және сақтауға дейінгі мәндерді беретін жазба; тек launch_record дереккөзі үшін. |
| dimension_write | IBM өлшемі қабылдаушысының баптаулары: элемент атауы, атрибут, ата-ана және иерархия байланыстары. |
| file_kind=agent_folder | UBC Agent арқылы рұқсат етілген жергілікті қалтадағы файл. |