Az Oracle Analytics integrálása az Oracle Cloud Infrastructure Functions szolgáltatással

Integrálja az Oracle Analytics szolgáltatást az Oracle Cloud Infrastructure (OCI) függvényeivel, hogy használhassa őket az adatok átalakításához alkalmazott adatfolyamokban.

OCI-függvények használata az Oracle Analytics szolgáltatásban

Az adatokat átalakíthatja az Oracle Analytics szolgáltatásban az OCI-ban létrehozott függvények használatával. Egy nyelvátváltási függvény segítségével például az angol szöveget spanyolra vagy németre is átválthatja.

Először regisztrálnia kell az OCI-függvényeket az Oracle Analytics szolgáltatásban. Ezt követően bármelyik Oracle Analytics felhasználó használhatja őket az adatfolyamaiban, aki rendelkezik BI szolgáltatásadminisztrátor vagy DV tartalomkészítő jogosultsággal.

Az OCI Functions konfigurálása az Oracle Analytics szolgáltatásban való használathoz

Hozzon létre függvényeket az OCI konzolban, hogy használhassa őket az adatok Oracle Analytics adatfolyamokban való átalakítására.

OCI-függvények regisztrálása az Oracle Analytics környezetben

Amikor regisztrál egy OCI-függvényt Oracle Analyics szolgáltatásban, ha szürkített a Függvény kiválasztása párbeszédpanelen, ellenőrizze, hogy konfigurálva van-e az oac-compatible címkével, és a megfelelő funcMode értékkel van-e meghívva.
A(z) GUID-6FE05B2C-5352-4953-998F-D967B6BA1891-default.png leírása
.png ábra leírása

OCI-függvények konfigurálása az Oracle Analytics környezetben való használathoz

Az Oracle Analytics szolgáltatásban használni kívánt OCI-függvényeknek oac-compatible címkével kell rendelkezniük, és a függvénymódnak tartalmaznia kell a funcMode változót. Ezeket a beállításokat az OCI konzol beállításai között konfigurálhatja:

oac-compatible - Adja hozzá ezt a szabad formátumú címként a függvényhez oac-compatible névvel, és állítsa true értékre.
.png ábra leírása
funcMode - Adja meg a funcMode változót a saját függvénykódjában. Az Oracle Analytics kérelmet küld az OCI-függvény regisztrálására a funcMode=describeFunction paranccsal, és egy kérelmet egy OCI-függvény meghívására a funcMode=executeFunction paranccsal. A func.py eseménykezelő függvénynek describeFunction vagy executeFunction módban kell működnie. Ez a funcMode bemeneti változó értéke alapján végezhető el, az alább látható kérelemből.

.png ábra leírása

Itt látható a kérelem és a válasz formátuma az OCI-függvények szószámhoz című példából Pythonban.

funcMode = describeFunction
```
{ "funcMode": "describeFunction"}
```
Ha a funcMode a kérelemben 'describeFunction', a függvénynek állapotot (returnCode és errorMessage), kimeneteket (kimeneti oszlop neve, dataType), paramétereket (bemeneti paraméter neve, leírása, típusa stb.), bucketName értéket stb. kellene visszaadnia JSON objektumként, az alábbi formátumban (szószám példája):
```
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
    }
}
```
Adja hozzá az alábbi kódot a func.py-ban, hogy a funcDefinition értékét kapja vissza, amikor a funcMode értéke a kérelemben '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 - Ha a funcMode értéke 'executeFunction', a tényleges függvénylogikát kellene végrehajtani, a választ pedig vissza kellene küldeni az Oracle Analytics szolgáltatásba, a kimenettel együtt. Ha a regisztrált függvényt meghívták az Oracle Analytics adatfolyamából, a kérelemobjektum az alábbi formátumban jelenik meg, az oszlopnévvel az argumentumokban, bemenet(bucketName, fileName, fileExtension, fileName, módszer és rowID) és kimenet(bucketName, fileName és fileExtension).
```
{
    "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"
    }
}
```

Függvények létrehozása az OCI szolgáltatásban

Az OCI konzol, parancssor (Fn Project CLI) vagy API segítségével is létrehozhat függvényeket Az OCI konzolban például kattintson a Fejlesztői szolgáltatások, majd a Függvények elemre, és kövesse a képernyőn megjelenő instrukciókat az alkalmazások és egy vagy több függvény létrehozásához. A részleteket lásd: Függvények létrehozása az OCI-dokumentációban. Ha először hoz létre függvényeket, kövesse a teljes példa lépéseit Egy Helloworld függvény létrehozása, telepítése és meghívása. Bármely Oracle Analytics szolgáltatásban használni kívánt függvénynek tartalmaznia kell az oac-compatible=true szabad formátumú címkét (lásd fent: OCI-függvények konfigurálása az Oracle Analytics szolgáltatásban).

Tippek függvények létrehozásához OCI konzolban

Naplók engedélyezése - Alapértelmezés szerint a naplók le vannak tiltva függvények esetében. Ha engedélyezni szeretné a naplókat függvényekhez, az Alkalmazások lapon kattintson a Naplók elemre, és engedélyezze a Naplónév lehetőséghez megadott naplót. Az Erőforrások lehetőség alatt mostantól kijelölheti a Napló feltárása lehetőséget, és elmélyedhet a naplóbejegyzésekben a függvényproblémák hibakereséséhez és diagnosztizálásához.
Függőségek belefoglalása - Függő csomagok belefoglalása a függvény requirements.txt fájljába.
Behúzási szabályok követése - A Python behúzási szabályainak követése Python-függvények kódolása során.
Függvényválaszhibák használata - Az Adatfolyam csomagban felsorolt hibaadatok használata a problémák diagnosztizálásához.
Függvények helyi tesztelése először - Mielőtt létrehozná a függvényt OCI-ban, tesztelje helyileg a saját fejlesztési környezetében, hogy biztosítsa a függvény szintaktikai és logikai helyességét.
Függvények tesztelése az OCI szolgáltatásban - A függvények Oracle Analytics szolgáltatással való integrálása előtt győződjön meg arról, hogy egyedülálló függvényekként is sikeresen tudja telepíteni és meghívni őket OCI-ban.
Időtúllépés növelése - Alapértelmezés szerint a függvények időtúllépése 30 másodperc. Ha szükséges, növelje az időtúllépés beállítását (például módosítsa 300 másodpercre) az OCI Konzol Függvény szerkesztése oldalán.
Memória növelése - Alapértelmezés szerint a függvények 1024 MB-os memóriakorláttal rendelkeznek. Ha szükséges, növelheti a memóriakorlátot az OCI Konzol Függvény szerkesztése oldalán.
Tárhely optimalizálása - Használat után haladéktalanul törölje a nem használt fájlokat.
Ügyeljen a hálózati késedelemre - Vegye figyelembe, hogy a hálózati késedelem az általános feldolgozás kis késését okozhatja.

Az OCI-függvények és az Oracle Analytics integrálásához szükséges alapszabályok

Az Oracle Analytics és az OCI-függvények integrálásához győződjön meg arról, hogy rendelkezik a szükséges biztonsági alapszabályokkal.

Az OCI felhasználónak, akit Ön az Oracle Analytics Cloud és az OCI bérlet közötti összefüggésben megad, olvasási, írási és törlési engedélyekkel kell rendelkeznie a használni kívánt OCI-erőforrásokat tartalmazó kompartmenthez. Győződjön meg arról, hogy az OCI-felhasználó olyan felhasználói csoporthoz tartozik, amely rendelkezik a következő OCI biztonsági alapszabályokkal. Ha az Oracle Analytics szolgáltatásból kapcsolódik OCI bérlethez, használhat OCI API-kulcsot vagy erőforrás-résztvevőt.

Megjegyzés:

Erőforrás-résztvevő használata esetén ha minden Analytics-példányt egyetlen kompartmentbe szeretne belefoglalni, adja meg ezt: {request.principal.type='analyticsinstance', request.principal.compartment.id='<compartmentA_ocid>'}, ne pedig ezt: {request.principal.id='<analytics_instance_ocid>'}.

API-kulcsokra vonatkozó alapszabályok	Erőforrások egyszerű nevére vonatkozó alapszabályok
`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>'}`

Dinamikus csoportra vonatkozó alapszabályok	Leírás
`Allow dynamic-group <dynamic_group> to manage objects in compartment <compartment_name> where target.bucket.name='<staging_bucket_name>'`	Hozzáférést biztosít a dinamikus csoport szakaszos gyűjtőjéhez.

Példa egyeztetési szabály: <dynamic_group>.{resource.type = 'fnfunc', resource.compartment.id = '<compartment_ocid>'}, ahol a <compartment_ocid> a függvényeket tartalmazó kompartment Oracle Cloud ID azonosítója.

Az OCI-függvények használatával történő adatátalakítás jellemző munkafolyamata

Ezeket a magas szintű feladatokat az alábbi sorrendben követve alakíthatja át az adatait az Oracle Analytics programban az OCI-függvények használatával.

Feladat	Leírás	További információk
Függvények létrehozása az OCI szolgáltatásban (függvényfejlesztő jogosultságok szükségesek)	Az OCI bérletében hozza létre saját függvényeit, és győződjön meg arról, hogy igazodnak az Oracle Analytics szolgáltatással való használathoz megadott előfeltételekhez.	Az OCI Functions konfigurálása az Oracle Analytics szolgáltatásban való használathoz
OCI-alapszabályok hozzárendelése	Győződjön meg arról, hogy rendelkezik a szükséges OCI-alapszabályokkal az API-kulcs vagy erőforrás-résztvevő használatával való kapcsolódáshoz.	Az OCI-függvények és az Oracle Analytics integrálásához szükséges alapszabályok
Az Oracle Analytics csatlakoztatása az OCI bérlethez (adminisztrátori vagy DV-szerzői jogosultságok szükségesek)	Az Oracle Analytics szolgáltatásban hozzon létre kapcsolatot a bérletével.	Kapcsolat létrehozása az Oracle Cloud Infrastructure-bérlettel
OCI-függvények regisztrálása az Oracle Analytics szolgáltatásban (adminisztrátori vagy DV-szerzői jogosultságok szükségesek)	Regisztrálja Oracle Analytics környezetben az OCI-függvényeit, hogy be tudja hívni őket az adatfolyamokból.	OCI-függvények regisztrálása az Oracle Analytics szolgáltatásban
Adatok átalakítása az OCI-függvények használatával (adminisztrátori vagy DV-szerzői jogosultságok szükségesek)	Hozzon létre egy adatfolyamot, és használja az Egyéni szkript alkalmazása lépést az OCI-függvény meghívásához.	Adatok átalakítása OCI-függvények használatával

OCI-függvények regisztrálása az Oracle Analytics szolgáltatásban

Regisztrálja az OCI-függvényeit az Oracle Analytics szolgáltatásban, hogy használhassa őket az adatok átalakításához alkalmazott adatfolyamokban. Egy nyelvátváltási függvény regisztrálásának segítségével például az adatelemzők az angol szöveget spanyolra vagy németre is átválthatják.

Az Oracle Analytics kezdőlapján kattintson az Oldalmenü, majd a Modell/függvény regisztrálása, végül az OCI-függvények elemre.
Az Egyéni függvény regisztrálása párbeszédpanel alatt válasszon egy kapcsolatot ahhoz az OCI bérlethez, amelyben a függvényei találhatók.
Az Alkalmazás kiválasztása párbeszédpanelen válassza ki azt az alkalmazást, amelyik tartalmazza az OCI-függvényeit.
Ha nem biztos benne, kérdezze meg azt a személyt, aki a függvényeket létrehozta az OCI-ban.
A Függvény kiválasztása párbeszédpanelen válasszon egy függvényt, majd kattintson a Regisztrálás lehetőségre.
Ha a használni kívánt függvény szürkített, kérje meg az adminisztrátort, hogy ellenőrizze, konfigurálva van-e az Oracle Analytics szolgáltatáshoz. Lásd: Az OCI Functions konfigurálása az Oracle Analytics szolgáltatásban való használathoz.

Az adatok átalakításához használhatja az adatfolyamok regisztrált OCI-függvényeit. Ha ellenőrizni szeretné, hogy mely függvények vannak regisztrálva, megtekintheti a regisztrált függvényeket a Parancsfájlok lapon a Gépi tanulás oldalon (a Kezdőlapon kattintson a Navigátor

gombra, majd a Gépi tanulás, végül a Parancsfájlok elemre).