Oracle Cloud Infrastructure -toimintojen integrointi Oracle Analytics -palveluun

Integroi Oracle Cloud Infrastructure (OCI) -toiminnot Oracle Analytics -palveluun, jotta voit käyttää niitä tietovirroissa tietojen muuntamiseen.

Tietoja OCI Functions -alustan käytöstä Oracle Analytics -ohjelmassa

Tietoja voi muuntaa Oracle Analytics -ohjelmassa käyttämällä OCI:ssa luotuja toimintoja. Voit esimerkiksi käyttää kielenmuunnostoimintoa, jotta voit muuntaa englanninkielistä tekstiä espanjaksi tai saksaksi.

Rekisteröi OCI-toiminnot ensin Oracle Analyticsissa. Sitten Oracle Analytics -käyttäjät, joilla on BI-palvelun järjestelmänvalvojan tai DV-sisällön laatijan oikeudet, voivat käyttää niitä tietovirroissaan.

Tietoja OCI-toimintojen konfiguroinnista Oracle Analytics -ohjelmaa varten

Luo OCI-konsolissa toimintoja, joita voit käyttää tietojen muuntamiseen Oracle Analytics -tietovirroissa.

Tietoja OCI-toimintojen rekisteröinnistä Oracle Analytics -ohjelmassa

Jos rekisteröit OCI-toiminnon Oracle Analytics -palvelussa ja se näkyy harmaana Toiminnon valinta -valintaikkunassa, tarkista, että sille on konfiguroitu oac-compatible-tunniste ja että sitä on kutsuttu oikealla funcMode-arvolla.
Kohteen GUID-6FE05B2C-5352-4953-998F-D967B6BA1891-default.png kuvaus seuraa
.png kuvaus

Tietoja OCI-toimintojen konfiguroinnista Oracle Analytics -ohjelmaa varten

Oracle Analytics -palvelussa käytettävillä OCI-toiminnoilla täytyy olla oac-compatible-tunniste ja toiminnon koodin täytyy sisältää funcMode-muuttuja. Konfiguroi nämä asetukset OCI-konsolissa:

oac-compatible - Lisää vapaamuotoinen tunniste toimintoon nimellä oac-compatible ja aseta sen arvoksi tosi.
.png kuvaus

funcMode - Sisällytä funcMode-muuttuja toiminnon koodiin. Oracle Analytics lähettää OCI-toiminnon rekisteröintipyynnön, jossa funcMode=describeFunction sekä OCI-toiminnon kutsupyynnön, jossa funcMode=executeFunction. Func.py-tiedoston käsittelijätoiminnon pitää toimia describeFunction-tilassa tai executeFunction-tilassa. Tila valitaan pyynnön syötemuuttujan funcMode arvon perusteella, kuten alla kuvataan.

Kohteen GUID-0C335709-DEDC-4655-8A29-F544608DA8B3-default.png kuvaus seuraa
.png kuvaus

Tässä on OCI-toimintojen pyyntö- ja vastausmuoto Python-kielisessä sanamäärän laskentaesimerkissä.

funcMode = describeFunction

{ "funcMode": "describeFunction"}

Kun funcMode-arvo on pyynnössä describeFunction, toiminnon pitäisi palauttaa mm. toiminnon kuvaus ja tila (paluukoodi ja virheilmoitus), tulosteet (tulostussarakkeen nimi ja tietotyyppi), parametrit (syöteparametrin nimi, kuvaus, tyyppi jne.) ja säilön nimi JSON-objektina seuraavassa muodossa (sanamääräesimerkki):

funcDefinition = {
    "status": {
        "returnCode": 0,
        "errorMessage": ""
    },
    "funcDescription": {
        "outputs": [
            {"name": "word_count", "dataType": "integer"}
        ],
        "parameters": [
            {"name": "textColumn", "displayName": "Text Column",
             "description": "Choose column to count words", "required": True,
             "value": {"type": "column"}}
        ],
        "bucketName": "bucket-OCI-FAAS",
        "isOutputJoinableWithInput": True
    }
}

Lisää seuraava koodi func.py-tiedostoon palauttaaksesi funcDefinition-tuloksen, kun pyynnön funcMode on describeFunction.

def handler(ctx, data: io.BytesIO = None):
    response_data = ""
    try:
        body = json.loads(data.getvalue())
        funcMode = body.get("funcMode")
        if funcMode == 'describeFunction':
           response_data = json.dumps(funcDefinition)
    except (Exception, ValueError) as ex:
        response_data = json.dumps(
            {"error": "{0}".format(str(ex))})
    return response.Response(
        ctx, response_data,
        headers={"Content-Type": "application/json"}
    )

funcMode = executeFunction - Kun funcMode on executeFunction, suoritetaan toiminnon varsinainen logiikka, ja vastaus lähetetään takaisin Oracle Analytics -ohjelmaan tulostuksen mukana. Kun rekisteröityä toimintoa kutsutaan Oracle Analyticsin tietovirrasta, pyyntöobjekti määritetään seuraavassa muodossa, johon sisältyy sarakkeen nimi (args), syöte (säilön nimi, tiedostonimi, tiedostopääte, menetelmä ja rivin tunnus) ja tuloste (säilön nimi, tiedostonimi ja tiedostopääte).

{
    "args":
    {
        "textColumn": "REVIEW"
    },
    "funcMode": "executeFunction",
    "input":
    {
        "bucketName": "bucket-OCI-FAAS",
        "fileExtension": ".csv",
        "fileName": "oac-fn-e99cd4fddb3844be89c7af6ea4bbeb76-input",
        "method": "csv",
        "rowID": "row_id"
    },
    "output":
    {
        "bucketName": "bucket-OCI-FAAS",
        "fileExtension": ".csv",
        "fileName": "oac-fn-e99cd4fddb3844be89c7af6ea4bbeb76-output"
    }
}

Tietoja toimintojen luonnista OCI-ympäristössä

Voit luoda toimintoja OCI-konsolin, komentorivin (Fn Project CLI) tai API-rajapinnan avulla. Esimerkiksi OCI-konsolissa voit valita Kehittäjäpalvelut ja sitten Toiminnot ja luoda sovelluksia ja yhden tai useampia toimintoja näytön ohjeita seuraamalla. Lisätietoja on kohdassa Toimintojen luonti OCI-dokumentaatiossa. Jos luot toimintoja ensimmäistä kertaa, käy läpi vaiheittaiset ohjeet esimerkissä Helloworld-toiminnon luonti, käyttöönotto ja kutsuminen. Kaikissa toiminnoissa, joita halutaan käyttää Oracle Analytics -ohjelmassa, on oltava vapaamuotoinen tunniste oac-compatible=true (katso Tietoja OCI-toimintojen konfiguroinnista Oracle Analytics -ohjelmaa varten edellä).

Vinkkejä toimintojen luontiin OCI-konsolissa

Ota lokit käyttöön- Oletuksen mukaan lokit eivät ole käytössä toiminnoille. Ota lokit käyttöön toiminnoille valitsemalla Sovellukset-sivulla Lokit ja ottamalla Lokin nimi -kohdassa määritetty loki käyttöön. Resurssit-kohdassa voit nyt valita kohdan Tutki lokia ja siirtyä lokikirjauksiin toiminnon ongelmien selvittämiseksi ja korjaamiseksi.
Sisällytä riippuvuudet - Sisällytä riippuvaiset paketit toiminnon requirements.txt-tiedostoon.
Noudata sisennyssääntöjä- Noudata Pythonin sisennyssääntöjä, kun koodaat Python-toimintoja.
Käytä toiminnon vastausvirheitä - Käytä Tietovirta-sivulla lueteltuja virhetietoja vianmäärityksessä.
Testaa toiminnot ensin paikallisesti - Ennen kuin luot toiminnon OCI-ympäristössä, testaa se paikallisesti kehitysympäristössäsi, jotta toiminnon syntaksi ja logiikka ovat varmasti oikein.
Testaa toiminnot OCI-ympäristössä - Ennen kuin integroit toiminnot Oracle Analytics -ohjelmaan, varmista, että pystyt ottamaan ne käyttöön ja kutsumaan niitä erillisinä toimintoina OCI-ympäristössä.
Pidennä aikakatkaisua- Oletuksen mukaan toimintojen aikakatkaisu on 30 sekuntia. Pidennä tarvittaessa aikakatkaisulle asetettua aikaa (voit esimerkiksi vaihtaa ajaksi 300 sekuntia) OCI-konsolinMuokkaa toimintoa -sivulla.
Lisää muistia - Oletuksen mukaan toimintojen muistin yläraja on 1024 Mt. Voit tarvittaessa nostaa muistin ylärajaa OCI-konsolin Muokkaa toimintoa -sivulla.
Optimoi tila - Poista tarpeettomat tiedostot heti käytön jälkeen.
Huomioi verkkoviive - Muista, että verkon viive voi aiheuttaa käsittelyssä hieman yleistä viivästystä.

OCI-toimintojen ja Oracle Analytics -palvelun integrointiin vaaditut käytännöt

Varmista, että seuraavat suojauskäytännöt ovat käytössä, jotta voit integroida Oracle Analytics -palvelun ja OCI-toiminnot.

Oracle Analytics Cloudin ja OCI-asiakastilin välisessä yhteydessä määritetyllä OCI-käyttäjällä on oltava luku-, kirjoitus- ja poisto-oikeudet siinä osastossa, joka sisältää käytettävät OCI-resurssit. Varmista, että OCI-käyttäjä kuuluu käyttäjäryhmään, jolla on vähintään seuraavat OCI-suojauskäytännöt. Kun muodostat yhteyden OCI-asiakastiliin Oracle Analytics -palvelusta, voit käyttää joko OCI-API-avainta tai resurssin objektia.

Huomautus::

Jos käytetään resurssin objektia, kaikki osaston Analytics-instanssit sisältävä määritys on {request.principal.type='analyticsinstance', request.principal.compartment.id='<compartmentA_ocid>'} määrityksen {request.principal.id='<analytics_instance_ocid>'} sijaan.

API-avainkäytännöt	Resurssin objektin käytännöt
`Allow group <group_name> to use functions-family in compartment <compartment_name>`	`Allow any-user to use functions-family in compartment <compartment_name> where all {request.principal.id='<analytics_instance_ocid>'}`
`Allow group <group_name> to read buckets in compartment <compartment_name>`	`Allow any-user to read buckets in compartment <compartment_name> where all {request.principal.id='<analytics_instance_ocid>'}`
`Allow group <group_name> to manage objects in compartment <compartment_name> where target.bucket.name='<staging_bucket_name>'`	`Allow any-user to manage objects in compartment <compartment_name> where all {request.principal.id='<analytics_instance_ocid>', target.bucket.name='<staging_bucket_name>'}`
`Allow group <group_name> to read objectstorage-namespaces in tenancy`	`Allow any-user to read objectstorage-namespaces in tenancy where all {request.principal.id='<analytics_instance_ocid>'}`

Dynaamisen ryhmän käytännöt	Kuvaus
`Allow dynamic-group <dynamic_group> to manage objects in compartment <compartment_name> where target.bucket.name='<staging_bucket_name>'`	Antaa käyttöoikeudet dynaamisen ryhmän vaihesäilöön.

Esimerkki vastaavuussäännöstä: <dynamic_group>.{resource.type = 'fnfunc', resource.compartment.id = '<compartment_ocid>'}, jossa <compartment_ocid> on funktiot sisältävän osaston Oracle Cloud -tunnus.

Tyypillinen työnkulku muunnettaessa tietoja OCI-toiminnoilla

Muunna tietoja Oracle Analytics -palvelussa OCI-toiminnoilla noudattamalla näitä korkean tason tehtäviä alla kuvatussa järjestyksessä.

Tehtävä	Kuvaus	Lisätietoja
Luo toiminnot OCI-ympäristössä (edellyttää toimintojen kehittäjän käyttöoikeuksia)	Luo toiminnot OCI-asiakastilillä ja varmista, että ne ovat Oracle Analytics -palvelun käyttöedellytysten mukaisia.	Tietoja OCI-toimintojen konfiguroinnista Oracle Analytics -ohjelmaa varten
Määritä OCI-käytännöt	Varmista, että olet määrittänyt tarvittavat OCI-käytännöt yhteyden muodostamiseen API-avaimen tai resurssin objektin avulla.	OCI-toimintojen ja Oracle Analytics -palvelun integrointiin vaaditut käytännöt
Yhdistä Oracle Analytics OCI-asiakastiliisi (edellyttää järjestelmänvalvojan tai tietojen visualisoinnin tekijän käyttöoikeuksia)	Luo Oracle Analytics -palvelussa yhteys OCI-asiakastiliisi.	Yhteyden luonti Oracle Cloud Infrastructure -asiakastiliin
Rekisteröi OCI-toiminnot Oracle Analytics -palveluun (edellyttää järjestelmänvalvojan tai tietojen visualisoinnin tekijän käyttöoikeuksia)	Rekisteröi OCI-toimintosi Oracle Analytics -palveluun, jotta voit kutsua niitä tietovirroista.	OCI-toimintojen rekisteröinti Oracle Analytics -palveluun
Muunna tiedot OCI-toiminnoilla (edellyttää järjestelmänvalvojan tai tietojen visualisoinnin tekijän käyttöoikeuksia)	Luo tietovirta ja käytä Käytä mukautettua komentosarjaa -vaihetta OCI-toiminnon kutsumiseen.	Tietojen muuntaminen OCI-toiminnoilla

OCI-toimintojen rekisteröinti Oracle Analytics -palveluun

Rekisteröi OCI-toimintoja Oracle Analytics -palvelussa, jotta voit käyttää niitä tietovirroissa tietojen muuntamiseen. Voit esimerkiksi rekisteröidä kielenmuunnostoiminnon, jotta data-analyytikot voivat muuntaa englanninkielistä tekstiä espanjaksi tai saksaksi.

Valitse Oracle Analytics -kotisivulla sivuvalikko, sitten Rekisteröi malli/toiminto ja sitten OCI-toiminnot.
Valitse Mukautetun toiminnon rekisteröinti -valintaikkunassa yhteys OCI-asiakastiliin, jossa toimintosi sijaitsevat.
Valitse Sovelluksen valinta -valintaikkunassa sovellus, joka sisältää OCI-toimintosi.
Jos et ole varma, kysy neuvoa henkilöltä, joka loi toiminnot OCI-ympäristössä.
Valitse Toiminnon valinta -valintaikkunassa toiminto ja sitten Rekisteröi.
Jos haluamasi toiminto näkyy harmaana, pyydä järjestelmänvalvojaa varmistamaan, että se on konfiguroitu Oracle Analytics -palvelua varten. Katso kohta Tietoja OCI-toimintojen konfiguroinnista Oracle Analytics -ohjelmaa varten.

Voit käyttää rekisteröityjä OCI-toimintoja tietovirroissa tietojen muuntamiseen. Tarkista, mitkä toiminnot on rekisteröity, tarkastelemalla rekisteröityjä toimintoja Koneoppiminen-sivun Komentosarjat-välilehdellä (valitse Koti-sivulta Navigointi, sitten Koneoppiminen ja Komentosarjat).