foreign.h 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. /*-------------------------------------------------------------------------
  2. *
  3. * foreign.h
  4. * support for foreign-data wrappers, servers and user mappings.
  5. *
  6. *
  7. * Portions Copyright (c) 1996-2016, PostgreSQL Global Development Group
  8. *
  9. * src/include/foreign/foreign.h
  10. *
  11. *-------------------------------------------------------------------------
  12. */
  13. #ifndef FOREIGN_H
  14. #define FOREIGN_H
  15. #include "nodes/parsenodes.h"
  16. /* Helper for obtaining username for user mapping */
  17. #define MappingUserName(userid) \
  18. (OidIsValid(userid) ? GetUserNameFromId(userid, false) : "public")
  19. /*
  20. * Generic option types for validation.
  21. * NB! Thes are treated as flags, so use only powers of two here.
  22. */
  23. typedef enum
  24. {
  25. ServerOpt = 1, /* options applicable to SERVER */
  26. UserMappingOpt = 2, /* options for USER MAPPING */
  27. FdwOpt = 4 /* options for FOREIGN DATA WRAPPER */
  28. } GenericOptionFlags;
  29. typedef struct ForeignDataWrapper
  30. {
  31. Oid fdwid; /* FDW Oid */
  32. Oid owner; /* FDW owner user Oid */
  33. char *fdwname; /* Name of the FDW */
  34. Oid fdwhandler; /* Oid of handler function, or 0 */
  35. Oid fdwvalidator; /* Oid of validator function, or 0 */
  36. List *options; /* fdwoptions as DefElem list */
  37. } ForeignDataWrapper;
  38. typedef struct ForeignServer
  39. {
  40. Oid serverid; /* server Oid */
  41. Oid fdwid; /* foreign-data wrapper */
  42. Oid owner; /* server owner user Oid */
  43. char *servername; /* name of the server */
  44. char *servertype; /* server type, optional */
  45. char *serverversion; /* server version, optional */
  46. List *options; /* srvoptions as DefElem list */
  47. } ForeignServer;
  48. typedef struct UserMapping
  49. {
  50. Oid umid; /* Oid of user mapping */
  51. Oid userid; /* local user Oid */
  52. Oid serverid; /* server Oid */
  53. List *options; /* useoptions as DefElem list */
  54. } UserMapping;
  55. typedef struct ForeignTable
  56. {
  57. Oid relid; /* relation Oid */
  58. Oid serverid; /* server Oid */
  59. List *options; /* ftoptions as DefElem list */
  60. } ForeignTable;
  61. extern ForeignServer *GetForeignServer(Oid serverid);
  62. extern ForeignServer *GetForeignServerByName(const char *name, bool missing_ok);
  63. extern UserMapping *GetUserMapping(Oid userid, Oid serverid);
  64. extern ForeignDataWrapper *GetForeignDataWrapper(Oid fdwid);
  65. extern ForeignDataWrapper *GetForeignDataWrapperByName(const char *name,
  66. bool missing_ok);
  67. extern ForeignTable *GetForeignTable(Oid relid);
  68. extern List *GetForeignColumnOptions(Oid relid, AttrNumber attnum);
  69. extern Oid get_foreign_data_wrapper_oid(const char *fdwname, bool missing_ok);
  70. extern Oid get_foreign_server_oid(const char *servername, bool missing_ok);
  71. #endif /* FOREIGN_H */