Funzioni condivisione dati fornitore

Le procedure qui elencate coprono tutte le funzioni richieste dal fornitore di una condivisione di dati.

Crea procedura provider

Questa funzione crea un destinatario condivisione dati.

Sintassi

Share.create_provider(name, endpoint, share_links, provider_type, bearer, client_id,
      client_secret, token_endpoint, description, owner )
Di seguito sono riportati i parametri e le descrizioni.
  • nome: il nome del destinatario. Questo campo è obbligatorio.
  • endpoint: questo campo visualizza l'endpoint del servizio Condivisione dati provider. Obbligatorio.
  • share_links: il dizionario dei collegamenti di condivisione del provider contiene i campi riportati di seguito.
    • [{"shareName":"shareNameValue", "shareLinkName":"shareLinkNameValue"}]

    Questo campo è obbligatorio.

  • tipo_provider*: questo campo visualizza il tipo di condivisione dati del provider. È possibile avere due valori, DELTA o LIVE.
  • portatore: questo campo visualizza il token del provider Data Share bearer. Questo campo è obbligatorio.
  • client_id: questo campo visualizza l'indirizzo ID client condivisione dati del provider. Questo campo è obbligatorio.
  • client_secret: questo campo visualizza il token segreto client condivisione dati del provider. Questo campo è obbligatorio.
  • token_endpoint: questo campo visualizza l'indirizzo endpoint del token di condivisione dati del provider. Questo campo è obbligatorio.
  • E-mail: questo campo visualizza l'indirizzo di posta del destinatario.
  • descrizione: questo campo visualizza la descrizione del provider. Se manca questo campo, lo strumento utilizza una stringa vuota.
  • Proprietario: questo campo visualizza il proprietario del provider. Se manca questo campo, lo strumento utilizza il proprietario dello schema corrente.

Esempio
In questo esempio è possibile creare un provider di condivisione dati:
provider_json = {
  "shareCredentialsVersion": 1,
  "endpoint": "https://abcd/delta-sharing/",
  "bearerToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

bearer_token   = provider_json['bearerToken']
endpoint       = provider_json['endpoint']
provider_name  = "provider_demo_delta_sharing_1"
description    = "provider demo delta sharing desc"
owner          = "ADMIN"
provider_type  = "DELTA"
share_links    = json.dumps([{"shareName":"DELTA_SHARING",
                              "shareLinkName":"DEMO_DELTA_SHARING"}])

adp.Share.create_provider (
    bearer         = bearer_token,
    description    = description,
    endpoint       = endpoint,
    name           = provider_name,
    owner          = owner,
    provider_type  = provider_type,
    share_links    = share_links)

//Output:
'{ "CreateShareProvider": true }'

Elimina procedura provider

Questa funzione elimina un provider di condivisione dati.

Sintassi

Share.delete_provider(name, owner)
Di seguito sono riportati i parametri e le descrizioni.
  • nome: il nome del destinatario. Questo campo è obbligatorio.
  • Proprietario: questo campo visualizza il proprietario del provider. Se manca questo campo, lo strumento utilizza il proprietario dello schema corrente.

Esempio
In questo esempio è possibile eliminare un provider condivisione dati:
adp.Share.delete_provider(name  = 'provider_demo_delta_sharing_2')

//Output:
'{ "status": true }'

Rinomina procedura provider

Questa funzione rinomina un provider condivisione dati.

Sintassi

Share.rename_provider(name, new_name, owner)
Di seguito sono riportati i parametri e le descrizioni.
  • nome: il nome del provider. Questo campo è obbligatorio.
  • nuovo_nome: in questo campo viene visualizzato il nome del provider di condivisione dati desiderato. Obbligatorio.
  • Proprietario: questo campo visualizza il proprietario del provider. Se manca questo campo, lo strumento utilizza il proprietario dello schema corrente.

Esempio
In questo esempio è possibile rinominare un provider condivisione dati:
adp.Share.rename_provider (name = 'provider_demo_delta_sharing_1', new_name = 'provider_demo_delta_sharing_2')

//Output:
'{ "status": true }'

Recupera procedura fornitore

Questa funzione riceve i dettagli del provider di condivisione dati.

Sintassi

Share.get_provider(name, owner)
Di seguito sono riportati i parametri e le descrizioni.
  • nome: il nome del provider. Questo campo è obbligatorio.
  • Proprietario: questo campo visualizza il proprietario del provider. Se manca questo campo, lo strumento utilizza il proprietario dello schema corrente.

Esempio
In questo esempio è possibile ricevere i dettagli di un provider di condivisione dati:
name = 'provider_demo_delta_sharing_2'
s = adp.Share.get_provider(name)
json.loads(s)

//Output:
{'name': 'PROVIDER_DEMO_DELTA_SHARING_2',
 'id': 40437,
 'endpoint': 'https://abcd/',
 'shareType': 'DELTA',
 'tokenEndPoint': None,
 'shareLinks': [{'name': 'DEMO_DELTA_SHARING',
   'id': 40438,
   'shareType': 'DELTA',
   'shareName': 'DELTA_SHARING'}]}

Ottieni fornitori

Questa funzione riceve un elenco dei provider di condivisione dati in base al proprietario del provider.

Sintassi

Share.get_providers(owner)
Di seguito sono riportati i parametri e le descrizioni.
  • nome: il nome del provider. Questo campo è obbligatorio.
  • endpoint: questo campo visualizza l'endpoint del servizio Condivisione dati provider. Obbligatorio.
  • share_links: il dizionario dei collegamenti di condivisione del provider contiene i campi riportati di seguito.
    • [{"shareName":"shareNameValue", "shareLinkName":"shareLinkNameValue"}]

    Questo campo è obbligatorio.

  • Proprietario: questo campo visualizza il proprietario del provider. Se manca questo campo, lo strumento utilizza il proprietario dello schema corrente.

Esempio
In questo esempio, è possibile ricevere un elenco di provider di condivisione dati:
s = adp.Share.get_providers()
json.loads(s)

//Output:
[{'id': 40437,
  'name': 'PROVIDER_DEMO_DELTA_SHARING_2',
  'owner': 'ADMIN',
  'endpoint': 'https://abcd/delta-sharing/',
  'shareType': 'DELTA'}]

Argomento padre: Funzioni di condivisione dati