수신자 데이터 공유 기능

여기에 나열된 절차에서는 데이터 공유 수신자가 요구하는 모든 기능을 다룹니다.

수신자 생성 프로시저

이 기능은 데이터 공유 수신자를 생성합니다.

구문

Share.create_recipient(name, email, description, owner, shares,
    token_lifetime)
다음은 매개변수 및 설명입니다.
  • name: 수신자의 이름입니다. 필수 사항입니다.
  • email(전자 메일): 이 필드에는 수신자의 메일 주소가 표시됩니다.
  • description(설명): 이 필드에는 수신자에 대한 설명이 표시됩니다. 이 필드가 누락된 경우 도구는 빈 문자열을 사용합니다.
  • 소유자: 이 필드에는 수신자 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.
  • shares: 수신자 공유 딕셔너리에서 "[{"name","shareNameValue"},...]" 필드를 볼 수 있습니다. 매개변수가 없는 경우 도구는 빈 사전 "[]"을 사용합니다.
  • token_lifetime: 이 도구는 수신자 토큰 수명을 'D HH:MM:SS' 형식으로 사용합니다. 이 필드가 누락된 경우 도구는 '0 00:60:00'을 사용합니다.

예
이 예에서는 데이터 공유 수신자를 생성할 수 있습니다.
adp.Share.create_recipient(
    name  = 'test_py_api_recipient_1',
    email = 'test@gmail.com'
)

//Output:
'{"createRecipient":true,"name":"TEST_PY_API_RECIPIENT_1"}'

수신자 공유 프로시저 갱신

이 기능은 데이터 공유 수신자를 업데이트합니다.

구문

Share.update_recipient_shares(name, shares, owner)
다음은 매개변수 및 설명입니다.
  • name: 수신자의 이름입니다. 필수 사항입니다.
  • 소유자: 이 필드에는 수신자 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.
  • shares: 수신자 공유 딕셔너리에서 "[{"name","shareNameValue"},...]" 필드를 볼 수 있습니다. 매개변수가 없는 경우 도구는 빈 사전 "[]"을 사용합니다.

예
이 예에서는 데이터 공유 수신자를 업데이트할 수 있습니다.
recipient_name = 'test_py_api_recipient_1'
shares = json.dumps([{"name":'share_py_api_7'}])
adp.Share.update_recipient_shares(name = recipient_name, shares = shares)

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

수신자 삭제 프로시저

이 기능은 데이터 공유 수신자를 삭제합니다.

구문

Share.delete_recipient(name, owner)
다음은 매개변수 및 설명입니다.
  • name: 수신자의 이름입니다. 필수 사항입니다.
  • 소유자: 이 필드에는 수신자 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

예
이 예에서는 데이터 공유 수신자를 삭제할 수 있습니다.
adp.Share.delete_recipient (name  = 'renamed_test_py_api_recipient_2')

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

수신자 이름 바꾸기 프로시저

이 함수는 데이터 공유 수신자의 이름을 바꿉니다.

구문

Share.rename_recipient(name, new_name, owner)
다음은 매개변수 및 설명입니다.
  • name: 수신자의 이름입니다. 필수 사항입니다.
  • new_name: 원하는 수신자의 이름입니다. 필수 사항입니다.
  • 소유자: 이 필드에는 수신자 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

예
이 예에서는 데이터 공유 수신자의 이름을 바꿀 수 있습니다.
adp.Share.rename_recipient(name = 'test_py_api_recipient_1', new_name = 'test_py_api_recipient_2')
//Output:
'{ "status": true }'

수신자 가져오기 프로시저

이 기능은 데이터 공유 수신자의 세부정보를 수신합니다.

구문

Share.get_recipient(name, owner)
다음은 매개변수 및 설명입니다.
  • name: 수신자의 이름입니다. 필수 사항입니다.
  • 소유자: 이 필드에는 수신자 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

예
이 예에서는 데이터 공유 수신자의 세부정보를 수신할 수 있습니다.
s = adp.Share.get_recipient('test_py_api_recipient_2')
json.loads(s)

//Output:
{'name': 'TEST_PY_API_RECIPIENT_2',
 'id': 40436,
 'type': 'DELTA_SHARING',
 'description': None,
 'email': 'test@gmail.com',
 'clientId': 'xxxxxxxxxxxx..',
 'clientSecret': 'xxxxxxxxxxxxxx..',
 'tokenDuration': None,
 'shares': [{'name': 'SHARE_PY_API_7',
   'id': 40419,
   'description': 'desc_share_py_api_7',
   'tablesCount': 2}],
 'created': '2024-11-12T15:34:08',
 'updated': '2024-11-12T15:36:13'}

수신자 가져오기 프로시저

이 함수는 데이터 스키마 수신자 소유자를 기반으로 데이터 공유 수신자 목록을 수신합니다.

구문

Share.get_recipients(owner)
다음은 매개변수 및 설명입니다.
  • 소유자: 이 필드에는 수신자 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

예
이 예에서는 데이터 공유 수신자 목록을 수신할 수 있습니다.
s = adp.Share.get_recipients()
json.loads(s)
//Output:
[{'id': 40436,
  'name': 'TEST_PY_API_RECIPIENT_2',
  'type': 'DELTA_SHARING',
  'description': None,
  'email': 'test@gmail.com'}]

수신자 공유 프로파일 가져오기 프로시저

이 기능은 수신자의 데이터 공유 프로파일을 수신합니다.

구문

Share.get_recipient_sharing_profile(name, owner)
다음은 매개변수 및 설명입니다.
  • name: 수신자의 이름입니다. 필수 사항입니다.
  • 소유자: 이 필드에는 수신자 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

예
이 예에서는 데이터 공유 수신자의 데이터 공유 프로파일을 수신할 수 있습니다.
s = adp.Share.get_recipient_sharing_profile('test_py_api_recipient_2')
json.loads(s)

//Output:
{'shareCredentialsVersion': 2,
 'type': 'persistent_oauth2.0',
 'endpoint': 'https://abc-xyz//xx/delta_sharing',
 'tokenEndpoint': 'https://abcdefg.xx.com/adp/admin/oauth/token',
 'clientId': 'abcdefghijklmnopg..',
 'clientSecret': 'abcdefrtyuioohh..'}

상위 항목: 데이터 공유 함수